Verwaltung und Programmierung

DBiAdminIsFileReferenced


Image Audio Video
X    

Gibt eine Liste mit Einträgen zu Abbildspalten in Benutzertabellen zurück, die auf eine angegebene Datei verweisen. Die Anwendung muß mit einer Datenbank verbunden sein, bevor diese API aufgerufen wird.

Es ist wichtig, daß Sie die Ressourcen, die durch diese API nach dem Aufruf zugeordnet werden, freigeben. Insbesondere müssen Sie die Dateilistendatenstruktur sowie das Feld für den Dateinamen in jedem Eintrag in der Dateiliste freigeben.

Berechtigung

SYSADM, SYSCTRL, SYSMAINT

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

libdmbimage.sl (HP-UX)

libdmbimage.so (Solaris)

Syntax

long DBiAdminIsFileReferenced(
      char *qualifier,
      char *fileName,
      long *count,
      FILEREF *(*tableList)
      );

Parameter

qualifier (Eingabe)
Eine gültige Benutzer-ID oder ein Nullwert. Wird eine Benutzer-ID angegeben, werden alle Tabellen mit dem angegebenen Qualifikationsmerkmal durchsucht. Wird ein Nullwert angegeben, werden alle Tabellen in der aktuellen Datenbank durchsucht.

fileName (Eingabe)
Der Name der Datei, auf die verwiesen wird.

count (Ausgabe)
Die Anzahl an Einträgen in der Ausgabeliste.

tableList (Ausgabe)
Eine Liste mit Tabelleneinträgen, die auf die angegebene Datei verweisen.

Fehlercodes

MMDB_SUCCESS
API-Aufruf erfolgreich verarbeitet.

MMDB_RC_NOT_CONNECTED
Keine gültige Verbindung zwischen Anwendung und Datenbank.

MMDB_RC_NO_AUTH
Benutzer verfügt nicht über die korrekte Berechtigung für den Aufruf dieser API.

MMDB_RC_MALLOC
System kann keinen Speicher für die Rückgabe der Ergebnisse zuordnen.

Beispiele

Auflisten der Einträge in Abbildspalten in allen Tabellen in der aktuellen Datenbank, die auf die Datei \images\asmith.bmp verweisen:

#include <dmbimage.h>
long idx;

rc = DBiAdminIsFileReferenced(NULL,
       "\images\asmith.bmp",
       &count, &tableList);


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

Search the DB2 Extender Books