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

DBaGetReferencedFiles


影像 音效 視訊
  X  

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

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

授權

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

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

libdmbaudio.sl (HP-UX)

libdmbaudio.so (Solaris)

併入檔

dmbaudio.h

語法

long DBaGetReferencedFiles(
      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 <dmbaudio.h>
long idx;
rc = DBaGetReferencedFiles("employee",
       &count, &filelist);


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