Image、Audio 及 Video Extenders 管理與程式設計

DBiBrowse


影像 音效 視訊
X    

開啟從屬站上的影像瀏覽器,並顯示影像。 此影像可儲存在影像直欄或外部檔中:

若瀏覽器無法直接存取影像,則 Extender 會在使用 DB2IMAGETEMP 環境變數指定的目錄中建立暫 用檔。然後,該 Extender 會由暫用檔中顯示該影像。

授權

假設您所瀏覽的是直欄中的影像,請選取使用者表格的權限。

檔案庫
OS/2 與 Windows AIX、HP-UX 及 Solaris
dmbimage.lib libdmbimage.a (AIX)

libdmbimage.sl (HP-UX)

libdmbimage.so (Solaris)

併入檔

dmbimage.h

語法

瀏覽儲存於直欄中的影像

long DBiBrowse(
      char *browserName,
      MMDB_PLAY_HANDLE,
      DB2Image *imageHandle,
      waitFlag
      );

語法

瀏覽儲存成檔案的影像

long DBiBrowse(
      char *browserName,
     MMDB_PLAY_FILE,
      char *fileName,
      waitFlag
      );

參數

browserName (in)
影像瀏覽器的名稱。假設您設為 NULL, 則會採用 DB2IMAGEBROWSER 環境變數所指定的預設影像瀏覽器。

MMDB_PLAY_HANDLE (in)
此常數指出將影像儲存成 BLOB。

MMDB_PLAY_FILE (in)
此常數指出將影像儲存成可自從屬站存取的檔案。

imageHandle (in)
影像的 handle。 在您瀏覽直欄中的影像時, 必須傳遞此參數。假設影像 handle 所呈現的是外部檔, 則會以從屬站環境變數 DB2IMAGEPATH 來分辨出檔案的位置。

fileName (in)
內含影像的檔案名稱。

waitFlag (in)
此常數是指出您的程式在繼續執行前,得花多久時間等待使用者關閉瀏覽器。 指定 MMDB_PLAY_WAIT,則會在和您的應用程式一樣的緒中執行瀏覽器; 指定 MMDB_PLAY_NO_WAIT,則是在個別緒中執行瀏覽器。

錯誤碼

MMDB_SUCCESS
API 呼叫程序執行成功。

MMDB_RC_NO_AUTH
呼叫程式不具備適當的存取權限。

MMDB_RC_NOT_CONNECTED
應用程式與資料庫之間無有效連接。

範例

顯示 imageHandle 所識別的影像。在和應用程式相同的緒中執行預設瀏覽器:

#include <dmbimage.h>
rc = DBiBrowse(NULL, MMDB_PLAY_HANDLE,
       imageHandle, MMDB_PLAY_WAIT);


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]