User manual - デバイス制御ライブラリ リファレンスマニュアルver.1.01(2009年1月21日)

101
9.2.8 fil_findfirst
ファイルの検索条件を指定して、条件に一致するファイル名を取得します。
ER fil_findfirst(
B * path ,
UH attr ,
FIND_T * buffer
);
パラメータ
path
検索対象ファイルのパスを、形式 2 で指定します。
attr
検索対象ファイルの属性を、次の値の組み合わせで指定します。
_A_NORMAL
：読み書き可能
_A_VOLID
：ボリューム ID
_A_RDONLY
：読取り専用
※
_A_SUBDIR
：サブディレクトリ
_A_HIDDEN
：隠しファイル
_A_ARCH
：アーカイブ
※
_A_SYSTEM
：システムファイル
※ アーカイブ/読取り専用属性は、指定の有無にかかわらず常に検索対象となります
buffer
検索結果を格納する、FIND_T 構造体のアドレスを指定します。
戻り値
関数が成功すると E_OK が返ります。失敗すると、次のエラーが返ります。
E_NG
： 異常終了
E_PRM
： パラメータエラー
解説
path パラメータの指定形式については、fil_remove 関数を参照してください。
path パラメータには、ワイルドカードを使用することができます。
次候補を読み出すときは、fil_findnext 関数を使用してください。
ファイルシステムが DT-700 互換モードの場合、
attr パラメータの指定は無視します。
参照
FIND_T 構造体､ fil_findnext 関数