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

DBvAdminGetReferencedFiles


影像 音效 視訊
    X

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

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

授權

SYSADM、SYSCTRL、SYSMAINT

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

libdmbvideo.sl (HP-UX)

libdmbvideo.so (Solaris)

併入檔

dmbvideo.h

語法

long DBvAdminGetReferencedFiles(
      char *qualifier,
      long *count,
      FILEREF *(*fileList)
      );

參數

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

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

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

錯誤碼

MMDB_SUCCESS
API 呼叫程序執行成功。

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

MMDB_RC_NO_AUTH
使用者沒有呼叫此 API 的適當權限。

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

範例

列出在 ajones 擁有的表格的視訊直欄中所參照到的檔案:

#include <dmbvideo.h>
long idx;
rc = DBvAdminGetReferencedFiles
       ("ajones", &count,
       &filelist);


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