Image, Audio und Video Extender Verwaltung und Programmierung
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:
- Nur EEE: QbQueryNameSearch wird nicht in einer Umgebung
für partitionierte Datenbanken unterstützt.
- 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 ]