Verwaltung und Programmierung

DBiBrowse


Image Audio Video
X    

Öffnet den Abbild-Browser auf dem Client und zeigt ein Abbild an. Das Abbild kann in einer Abbilddatei oder einer externen Datei gespeichert sein:

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