Image、Audio 及 Video Extenders 管理與程式設計
開啟從屬站上的影像瀏覽器,並顯示影像。
此影像可儲存在影像直欄或外部檔中:
- 若影像是儲存在外部檔中,
則您可以將檔名或影像 handle 傳遞給此 API。API 會利用從屬站環境變數 DB2IMAGEPATH,分辨出檔案的位置。
您必須自從屬站工作站來存取該檔案。
- 假設影像是儲存在直欄中,則您必須將影像 handle 傳遞給 API。
應用程式必須先連接到資料庫,而且必須有儲存影像的表格的讀取權。
若瀏覽器無法直接存取影像,則 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);
[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]