Image, Audio und Video Extender Verwaltung und Programmierung

QbQueryNameSearch


Image Audio Video
X    

Durchsucht den QBIC-Katalog nach Abbildern, die mit dem Suchkriterium im Abfrageobjekt übereinstimmen. Das Abfrageobjekt wird nach seinem Namen identifiziert. Die Ergebnisse, die die Abbildkennungen und das Ähnlichkeitsergebnis der QBIC-Suche beinhalten, werden in einem Ergebnisbereich im Client-Speicher gespeichert. Die Ergebnisse werden anhand ihrer Ähnlichkeitsergebnisse sortiert.

Anmerkungen:

  1. Nur EEE: QbQueryNameSearch wird nicht in einer Umgebung für partitionierte Datenbanken unterstützt.

  2. QbQueryNameSearch wird in zukünftigen Releases für Umgebungen für nicht partitionierte Datenbanken nicht mehr unterstützt. Um eine Abfrage zu sichern, sollten Sie die API QbQueryGetString verwenden, um die Abfragezeichenfolge abzurufen, und diese Zeichenfolge für die spätere Verwendung in Ihrer Anwendung sichern.

Berechtigung

SELECT

Bibliotheksdatei
OS/2 und Windows AIX, HP-UX und Solaris
dmbqqry.lib libdmbqqry.a (AIX)

libdmbqqry.sl (HP-UX)

libdmbqqry.so (Solaris)

Kopfdatei

dmbqbapi.h

Syntax

SQLRETURN QbQueryNameSearch(
      char *qName,
      char *tableName,
      char *columnName,
      SQLINTEGER maxReturns,
      QbQueryScope* scope,
      SQLINTEGER resultType,
      SQLINTEGER* count,
      QbResult* returns
      );

Parameter

qName (Eingabe)
Der Name des Abfrageobjekts.

tableName (Eingabe)
Der Name der Tabelle, die die Spalte mit Abbildern enthält, die durchsucht werden soll.

columnName (Eingabe)
Der Name der Abbildspalte. Die Spalte muß für Abbilddaten aktiviert sein.

maxReturns (Eingabe)
Die maximale Anzahl von Abbildern, die zurückgegeben werden sollen.

scope (Eingabe) (Reserviert)
Muß auf 0 (NULL) gesetzt sein.

resultType (Eingabe) (Reserviert)
Muß auf 'qbiArray' gesetzt sein.

count (Ausgabe)
Der Zeiger auf die Anzahl der zurückgegebenen Abbilder. Wird Null zurückgegeben, stellen Sie sicher, daß die Abbildspalte für alle Merkmale im Abfrageobjekt katalogisiert ist.

returns (Ausgabe)
Der Zeiger auf den Bereich von QbResult-Strukturen, die die zurückgegebenen Ergebnisse enthalten. Stellen Sie sicher, daß der Puffer, den Sie zuordnen, groß genug ist, um alle zu erwartenden Ergebnisse aufzunehmen.

Fehlercodes

qbiECinvalidQueryHandle
Die angegebene Kennung für das Abfrageobjekt verweist nicht auf ein gültiges Abfrageobjekt.

Beispiele

Ausführen der Abfrage FSHAVGCOL für die katalogisierten Abbilder in der Spalte 'picture' der Tabelle 'employee'. Sicherstellen, daß nicht mehr als sechs Abbilder zurückgegeben werden:

#include <dmbqbapi.h>
 
rc = QbQueryNameSearch("fshavgcol",
       "employee", "picture",
       6, 0, qbiArray, &count, &returns);


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]