User manual - デバイス制御ライブラリリファレンスマニュアル(2014年10月10日)

104
9.1.9 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
：システムファイル
(9) アーカイブ／読み取り専用属性は、指定の有無にかかわらず常に検索対象となります
buffer
検索結果を格納する、FIND_T構造体のアドレスを指定します。
戻り値
関数が成功すると E_OK が返ります。失敗すると、次のエラーが返ります。
E_NG
： 異常終了
E_PRM
： パラメータエラー
解説
path パラメータの指定形式については、fil_remove関数を参照してください。
path パラメータには、ワイルドカードを使用することができます。
次候補を読み出すときは、fil_findnext関数を使用してください。
ファイルシステムが DT-
700 互換モードの場合、
attr パラメータの指定は無視します。
参照
FIND_T構造体､ fil_findnext関数