Verwaltung und Programmierung

QbOpenCatalog


Image Audio Video
X    

Öffnet den QBIC-Katalog für eine bestimmte Abbildspalte. Sie können den Katalog im Lesemodus oder Aktualisierungsmodus öffnen. Die API gibt die Kennung für den geöffneten Katalog zurück. Sie können dann die Kennung in anderen APIs verwenden, um den Katalog zu verwalten und zu füllen.

Stellen Sie sicher, daß Sie den Katalog schließen, wenn Sie die Arbeit damit beendet haben.

Berechtigung

CONNECT

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

libdmbqbapi.sl (HP-UX)

libdmbqbapi.so (Solaris)

Syntax

sqlinteger QbOpenCatalog(
     char *tableName,
      char *columnName,
      sqlinteger mode,
      QbCatalogHandle *cHdl
      );

Parameter

tableName (Eingabe)
Der Name der Tabelle, die die Abbildspalte enthält.

columnName (Eingabe)
Der Name der Abbildspalte.

mode (Eingabe)
Der Modus, in dem der Katalog geöffnet wird. Gültige Werte sind qbiRead und qbiUpdate.

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

Fehlercodes

qbicECCatalogNotFound
Katalog konnte nicht gefunden werden.

qbicECCatalogInUse
Katalog wurde von einem anderen Benutzer verwendet.

qbicECOpenFailed
Katalog konnte nicht geöffnet werden.

qbicECNotEnabled
Katalog nicht aktiviert.

qbicECNoCatalogFound
Kein Katalog gefunden.

qbicECSqlError
SQL-Fehler aufgetreten.

qbicECSystem
Systemfehler aufgetreten.

Beispiele

Öffnen des Katalogs für die Spalte 'picture' in der Tabelle 'employee' im Lesemodus:

#include <dmbqbapi.h>

rc=QbOpenCatalog("employee", "picture",
     qbiread, &CatHdl);


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

Search the DB2 Extender Books