Verwaltung und Programmierung

QbQueryListFeatures


Image Audio Video
X    

Gibt eine aktuelle Liste von Merkmalen im Abfrageobjekt zurück. Die API gibt die Liste auf einem Puffer, den Sie zuordnen, zurück. 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)

Syntax

sqlinteger QbQueryListFeatures(
      QbQueryHandle qObj,
      sqlinteger bufSize,
      sqlinteger* count,
      char *featureNames
      );

Parameter

qObj (Eingabe)
Die Kennung des Abfrageobjekts.

bufSize (Eingabe)
Die Größe des Puffers 'featureNames'. Verwenden Sie die Konstante 'qbiMaxFeatureName' als Puffergröße. Merkmale eines Abfrageobjekts werden durch einen Zeichenfolgenamen identifiziert.

count (Ausgabe)
Die Anzahl der zurückgegebenen Merkmalnamen.

featureNames (Ausgabe)
Der Zeiger auf den Bereich von Merkmalnamen für das Abfrageobjekt. Der Bereich wird auf dem Puffer, den Sie zuordnen, gespeichert.

Fehlercodes

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

Beispiele

Rückgabe der Anzahl von Merkmalen im Abfrageobjekt, das durch die Kennung 'qoHandle' identifiziert wird. Verwendung der Konstanten 'qbiMaxFeatureName', um die Größe des benötigten Puffers zu bestimmen. Rückgabe des Merkmalnamens auf den Puffer 'feats' und Rückgabe der Anzahl von Merkmalen in der Variablen 'retCount':

#include <dmbqbapi.h>

bufSize = qbiMaxFeatureName;

rc = QbQueryListFeatures(qoHandle, bufSize,
        &retCount, feats);


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

Search the DB2 Extender Books