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

DBiGetReferencedFiles


影像 音效 視訊
X    

傳回使用者表格的影像直欄中所參照到的檔名。 若某檔案無法存取 (例如,無法使用環境變數規格來分辨檔名),則檔名前面會有一個星號。 由於此 API 不會用到 FILEREF 資料結構的 FILENAME 欄位, 因此請將此值設為 NULL。呼叫此 API 之前,應用程式必須先連接到資料庫。

呼叫此 API 之後,一定要釋放此 API 配置的資源。更明確的說法是,您必須釋放 filelist 資料結構。

授權

在所有已搜尋的使用者表格和相關管理支援表格中,已啟用影像直欄的 SELECT 專用權

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

libdmbimage.sl (HP-UX)

libdmbimage.so (Solaris)

併入檔

dmbimage.h

語法

long DBiGetReferencedFiles(
      char *tableName,
      long *count,
      FILEREF *(*fileList)
      );

參數

tableName (in)
完整、不完整、或 NULL 的表格名稱。 假設您指定的是表格名稱, 則會搜尋該表格,以找出會參照檔案的項目。若指定 NULL 值,則會搜尋現行使用者 ID 擁有的所有表格。

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

fileList (out)
表格中所參照的檔案列示。

錯誤碼

MMDB_SUCCESS
API 呼叫程序執行成功。

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

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

範例

列出所有在員工表格的影像直欄中所參照到的檔案:

#include <dmbimage.h>
long idx;
rc = DBiGetReferencedFiles("employee",
       &count, &filelist);


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