Verwaltung und Programmierung
Öffnet den Abbild-Browser auf dem Client und zeigt ein Abbild an.
Das Abbild kann in einer Abbilddatei oder einer externen Datei gespeichert
sein:
- Ist das Abbild in einer externen Datei gespeichert, können Sie entweder
den Namen der Datei oder die Abbildkennung an diese API übergeben. Die
API verwendet die Client-Umgebungsvariable DB2IMAGEPATH, um die Dateiadresse
aufzulösen. Auf die Datei muß von der Client-Datenstation aus
zugegriffen werden können.
- Ist das Abbild in einer Spalte gespeichert, müssen Sie die Abbildkennung
an die API übergeben. Die Anwendung muß mit der Datenbank verbunden
sein und über Lesezugriff auf die Tabelle verfügen, in der das Abbild
gespeichert ist.
Kann der Browser nicht direkt auf das Abbild zugreifen, erstellt der
Extender eine temporäre Datei in dem Verzeichnis, das in der
Umgebungsvariablen DB2IMAGETEMP angegeben ist. Der Extender zeigt dann
das Abbild von der temporären Datei an.
Berechtigung
Auswahlberechtigung (SELECT) für die Benutzertabelle, wenn ein Abbild in
einer Spalte angezeigt wird.
Bibliotheksdatei
OS/2 und Windows
| AIX, HP-UX und Solaris
|
dmbimage.lib
| libdmbimage.a (AIX)
|
| libdmbimage.sl (HP-UX)
|
| libdmbimage.so (Solaris)
|
Syntax
Anzeigen eines Abbilds, das in einer Spalte gespeichert ist
long DBiBrowse(
char *browserName,
MMDB_PLAY_HANDLE,
DB2Image *imageHandle,
waitFlag
);
Syntax
Anzeigen eines Abbilds, das als Datei gespeichert ist
long DBiBrowse(
char *browserName,
MMDB_PLAY_FILE,
char *fileName,
waitFlag
);
Parameter
- browserName (Eingabe)
- Der Name des Abbild-Browsers. Ist dieser Wert auf NULL gesetzt,
wird der Standardabbild-Browser verwendet, der in der Umgebungsvariablen
DB2IMAGEBROWSER angegeben ist.
- MMDB_PLAY_HANDLE (Eingabe)
- Eine Konstante, die angibt, daß das Abbild als BLOB gespeichert
ist.
- MMDB_PLAY_FILE (Eingabe)
- Eine Konstante, die angibt, daß das Abbild als Datei gespeichert ist, auf
die vom Client aus zugegriffen werden kann.
- imageHandle (Eingabe)
- Die Kennung für das Abbild. Dieser Parameter muß übergeben werden,
wenn Sie ein Abbild in einer Spalte anzeigen. Stellt die Abbildkennung
eine externe Datei dar, wird die Client-Umgebungsvariable DB2IMAGEPATH
verwendet, um die Dateiadresse aufzulösen.
- fileName (Eingabe)
- Der Name der Datei, die das Abbild enthält.
- waitFlag (Eingabe)
- Eine Konstante, die angibt, ob das Programm vor dem Fortfahren wartet, bis
der Benutzer den Browser schließt. MMDB_PLAY_WAIT führt den Browser auf
demselben Thread aus wie Ihre Anwendung. MMDB_PLAY_NO_WAIT führt den
Browser auf einem separaten Thread aus.
Fehlercodes
- MMDB_SUCCESS
- API-Aufruf erfolgreich verarbeitet.
- MMDB_RC_NO_AUTH
- Aufrufender verfügt nicht über die korrekte Zugriffsberechtigung.
- MMDB_RC_NOT_CONNECTED
- Keine gültige Verbindung zwischen Anwendung und Datenbank.
Beispiele
Anzeigen des Abbilds, das durch 'imageHandle' identifiziert
wird. Ausführen des Standard-Browsers auf demselben Thread wie die
Anwendung:
#include <dmbimage.h>
rc = DBiBrowse(NULL, MMDB_PLAY_HANDLE,
imageHandle, MMDB_PLAY_WAIT);
[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]
Search the DB2 Extender Books