Image, Audio und Video Extender Verwaltung und Programmierung

QbQuerySetFeatureData


Image Audio Video
X    

Definiert die Quelle von Abbilddaten für ein Merkmal in einem Abfrageobjekt. Sie können die Datenquelle erst definieren, nachdem Sie ein Merkmal zu einem Abfrageobjekt hinzugefügt haben. Die Datenquelle kann ein Abbild in einer Benutzertabelle, -datei oder in einem Workstation-Puffer sein. Sie können eine Client-Datei oder einen Workstation-Puffer nur in einer Umgebung für nicht partitionierte Datenbanken als Datenquelle verwenden. Darüber hinaus können Sie explizit Daten für das Merkmal 'Durchschnittsfarbe' oder 'Histogrammfarbe' angeben.

Verwenden Sie die API QbQueryStringSearch zum Definieren der Quelle für Abbilddaten in einer Server-Datei mit Hilfe von QbQuerySetFeatureData. QbQuerySearch verwendet nicht die Quelle für Abbilddaten aus einer Server-Datei, die mit QbQuerySetFeatureData definiert wurde.

Die folgenden Merkmale werden mit dem Image Extender zur Verfügung gestellt:

Berechtigung

Keine

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 QbQuerySetFeatureData(
      QbQueryHandle qObj,
      char *featureName,
      QbImageSource* imgSource
      );

Parameter

qObj (Eingabe)
Die Kennung des Abfrageobjekts.

featureName (Eingabe)
Der Name des zu definierenden Merkmals.

imgSource (Eingabe)
Der Zeiger auf die Abbildquellenstruktur. Wenn Sie 0 (NULL) für 'imgSource' angeben, bedeutet dies, daß die Informationen im Merkmal nicht geändert werden sollen. Weitere Informationen befinden sich im Abschnitt Strukturen für Datenquellen verwenden.

Fehlercodes

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

qbiECunknownFeatureClass
Angegebenes Merkmal ist kein gültiger Merkmalklassenname.

qbiECinvalidFeatureClass
Angegebenes Merkmal ist kein gültiges Namensformat.

qbiECfeatureNotPresent
Angegebenes Merkmal ist kein Member des Abfrageobjekts.

qbiECfileUnreadable
Abbildquellendatei kann nicht gefunden oder gelesen werden.

Beispiele

Setzen der Datenquelle für das Merkmal 'Histogrammfarbe' in einem Abfrageobjekt. Die Datenquelle für das Merkmal ist eine Datei auf der Client-Workstation:

#include <dmbqbapi.h>
 
QbQueryHandle qoHandle;
QbImageSource imgSource;
 
imgSource.sourceType = qbiSource_ClientFile;
strcpy(featureName, "QbColorHistogramFeatureClass");
strcpy(imgSource.clientFile, "/tmp/image.gif");
 
rc = QbQuerySetFeatureData(qoHandle, featureName, &imgSource);


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