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

DBiAdminIsFileReferenced


影像 音效 視訊
X    

傳回參照指定檔案的使用者表格中的影像直欄項目列示。 呼叫此 API 之前,應用程式必須先連接到資料庫。

呼叫此 API 之後,一定要釋放此 API 配置的資源。更明確的說法是,您必須釋放檔案列示資料結構, 以及檔案列示中每個項目中的檔名欄位。

授權

SYSADM、SYSCTRL、SYSMAINT

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

libdmbimage.sl (HP-UX)

libdmbimage.so (Solaris)

併入檔

dmbimage.h

語法

long DBiAdminIsFileReferenced(
      char *qualifier,
      char *fileName,
      long *count,
      FILEREF *(*tableList)
      );

參數

qualifier (in)
有效的使用者 ID 或 NULL 值。 若您指定的是使用者 ID,則會搜尋所有採用所指限定元的表格; 若指定 NULL 值,則會搜尋現行資料庫中的所有表格。

fileName (in)
被參照的檔案名稱。

count (out)
輸出列示中的登錄數目。

tableList (out)
參照指定檔案的表格項目列示。

錯誤碼

MMDB_SUCCESS
API 呼叫程序執行成功。

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

MMDB_RC_NO_AUTH
使用者在呼叫此 API 上並無適當權限。

MMDB_RC_MALLOC
系統無法配置記憶體供傳回結果時使用。

範例

列出參照檔案 /images/asmith.bmp 的現行資料庫中,所有表格的影像直欄項目:

#include <dmbimage.h>
long idx;
rc = DBiAdminIsFileReferenced(NULL,
       "/images/asmith.bmp",
       &count, &tableList);


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