Verwaltung und Programmierung

QbListFeatures


Image Audio Video
X    

Gibt eine Liste der aktiven Merkmale zurück, die momentan in einem Katalog enthalten sind. Die Liste wird auf einem Puffer, den Sie zuordnen, zurückgegeben.

Berechtigung

SELECT

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

libdmbqbapi.sl (HP-UX)

libdmbqbapi.so (Solaris)

Syntax

sqlinteger QbListFeatures(
      QbCatalogHandle *cHdl,
      sqlinteger bufSize,
      sqlinteger *count,
      char *featureNames
      );

Parameter

cHdl (Eingabe)
Der Zeiger auf die Kennung des Katalogs.

bufSize (Eingabe)
Die Größe Ihres Puffers. Um die benötigte Puffergröße zu schätzen, können Sie die Merkmalanzahl verwenden, die von der API QbGetCatalogInfo zurückgegeben wird, und sie mit der Länge des längsten Merkmalnamens multiplizieren. Merkmalnamen, die im Puffer gespeichert werden, werden durch Leerzeichen voneinander getrennt.

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

featureNames (Ausgabe)
Der Bereich von Merkmalnamen in Ihrem Puffer.

Fehlercodes

qbicECIvalidHandle
Katalogkennung ungültig.

qbicECTruncateData
Zurückgegebene Daten abgeschnitten, da der Rückgabepuffer zu klein war.

Beispiele

Abrufen einer Liste der aktiven Merkmale in dem Katalog, der durch die Kennung 'CatHdl' identifiziert wird. Speichern der Informationen im Bereich 'featureNames'.

Zunächst muß 'bufSize' berechnet werden, d. h. die Puffergröße, die für die Liste benötigt wird. Verwenden Sie die API QbGetCatalogInfo, um die Anzahl an Merkmalen in der Struktur 'catInfo' zurückzugeben. Multiplizieren Sie dann diese Zahl mit der Konstanten qbiMaxFeatureName, d. h. mit der Größe des längsten Merkmalnamens:

#include <dmbqbapi.h>

rc = QbGetCatalogInfo(CatHdl, &catInfo);

bufSize =
   catInfo.featureCount*qbiMaxFeatureName;

rc = QbListFeatures(CatHdl, bufSize,
       count, featureNames);


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

Search the DB2 Extender Books