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

108
9.1.13 fil_filefind
ファイルの検索を行ないます。
異なるパスに同じ名前のファイルが複数存在する場合、合致する順番のファイルを取得します。
ER fil_filefind(
B * path ,
UB * buffer ,
UB find_sw ,
UH seq_no
);
パラメータ
path
検索対象ファイルのパスを、形式 2 で指定します。
buffer
検索結果ファイルのパスを、形式 2 で格納する領域のアドレスを指定します。
find_sw
サブディレクトリの検索をする／しないを次の値で指定します。
FIL_SUBDIR_ON
：サブディレクトリ下を検索します
FIL_SUBDIR_OFF
：サブディレクトリ下は検索しません
seq_no
同じ名前のファイルが複数存在する場合に、何番目のファイルを取得するかを指定します。
戻り値
関数が成功すると E_OK が返ります。失敗すると、次のエラーが返ります。
E_NG
：異常終了
E_PRM
：パラメータエラー
解説
path パラメータの指定形式については、fil_remove関数を参照してください。
path パラメータには、ワイルドカードを使用することができます。
本関数が失敗する要因には次のものがあります。
 ファイル／パス名異常（使用不可コード混在）
 パス長異常（128 文字以上の指定）
 指定ドライブ未フォーマット
 指定ドライブ未搭載
 ドライブ指定外（C または F 以降）
 ファイル未検出
 指定ファイルが存在しない