イメージ、オーディオ、およびビデオ・エクステンダー 管理およびプログラミングの手引き

DBaAdminGetInaccessibleFiles


イメージ オーディオ ビデオ
O

ユーザー表の音声列で参照されているアクセス不能なファイルの名前を戻します。 この API を呼び出す前に、アプリケーションをデータベースに接続する必要があります。

呼び出し後、この API が割り振った資源を解放するのは重要なことです。 具体的には、filelist データ構造と、ファイル・リストのそれぞれの項目のファイル名フィールドを解放する必要があります。

許可

SYSADM、SYSCTRL、SYSMAINT

ライブラリー・ファイル
OS/2 および Windows AIX、HP-UX、および Solaris
dmbaudio.lib libdmbaudio.a (AIX)

libdmbaudio.sl (HP-UX)

libdmbaudio.so (Solaris)

インクルード・ファイル

dmbaudio.h

構文

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

パラメーター

qualifier (in)
有効なユーザー ID またはヌル値。 ユーザー ID を指定すると、この修飾子が指定されているすべての表が探索されます。 ヌル値を指定すると、現行データベースのすべての表が探索されます。

count (out)
出力リストの項目数。

fileList (out)
表で参照されているアクセス不能なファイルのリスト。

エラー・コード

MMDB_SUCCESS
正常に処理された API 呼び出し。

SQL_ERROR または他の SQL 戻りコード
DB2 から戻されたエラー。

MMDB_RC_NOT_CONNECTED
アプリケーションのデータベース接続が有効ではありません。

MMDB_RC_MALLOC
システムは、結果を戻すメモリーを割り振ることができません。

MMDB_RC_NO_AUTH
この API を呼び出すためのユーザー権限が正しくありません。

ユーザー ID rsmith が所有する表の音声列で参照されているすべてのアクセス不能ファイルのリストを表示するには、次のようにします。

#include <dmbaudio.h>
long idx;
rc = DBaAdminGetInaccessibleFiles("rsmith",
       &count, &filelist);


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]