Image, Audio und Video Extender Verwaltung und Programmierung

DBaGetReferencedFiles


Image Audio Video
  X  

Gibt die Namen der Dateien zurück, auf die in Audiospalten von Benutzertabellen verwiesen wird. Wenn eine Datei nicht zugänglich ist (beispielsweise, wenn der Dateiname unter Verwendung der Angaben für die Umgebungsvariable nicht aufgelöst werden kann), wird dem Dateinamen ein Stern vorangestellt. Diese API verwendet das Feld FILENAME der Datenstruktur FILEREF nicht und setzt es daher auf NULL. 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 freigeben.

Berechtigung

SELECT-Berechtigung für aktivierte Audiospalten in allen durchsuchten Benutzertabellen und zugehörigen Tabellen zur Verwaltungsunterstützung

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

libdmbaudio.sl (HP-UX)

libdmbaudio.so (Solaris)

Kopfdatei

dmbaudio.h

Syntax

long DBaGetReferencedFiles(
      char *tableName,
      long *count,
      FILEREF *(*fileList)
      );

Parameter

tableName (Eingabe)
Ein qualifizierter oder nicht qualifizierter Tabellenname bzw. ein Nullwert. Wird ein Tabellenname angegeben, wird diese Tabelle nach Verweisen auf Dateien durchsucht. Wird ein Nullwert angegeben, werden alle Tabellen in der Datenbank durchsucht, deren Eigner der Benutzer mit der aktuellen Benutzer-ID ist.

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

fileList (Ausgabe)
Eine Liste von Dateien, auf die in der Tabelle verwiesen wird.

Fehlercodes

MMDB_SUCCESS
API-Aufruf erfolgreich verarbeitet.

MMDB_RC_NOT_CONNECTED
Keine gültige Verbindung zwischen Anwendung und Datenbank.

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

Beispiele

Auflisten aller Dateien, auf die in Audiospalten in der Tabelle 'employee' verwiesen wird:

#include <dmbaudio.h>
long idx;
 
rc = DBaGetReferencedFiles("employee",
       &count, &filelist);


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