User manual - Cライブラリ解説書ver.2.00(2003年2月7日)
DT-900 C ライブラリ解説書
49
機能 ファイル全パス名の取得 関数名 fil_filefind
ファイルの検索を行ないます。
検索結果のファイル名は、パスを含んだ形式で取得されます。
パスの異なる同一名称のファイルが複数存在する場合、検索条件に順次合致していくなかで指定した番目に一致したファイル
を取得します。
≪C言語インタフェース≫
【コーリングシーケンス】
ER ercd = fil_filefind( B *path, UB *buffer, UB find_sw, UH seq_no );
【パラメータ】
B *path :検索するファイル名(指定方法は、open 関数参照。形式2のみ有効。ワイルドカード使用可)
UB *buffer :ファイル名を格納するバッファ(形式2で返却)
UB find_sw :サブディレクトリ下の検索指定
FIL_SUBDIR_ON :サブディレクトリ下まで検索する
FIL_SUBDIR_OFF :サブディレクトリ下は検索しない
UH seq_no :指定番目の番号
【リターンパラメータ】
ER ercd :リターンコード
【リターンコード】
E_OK :正常終了
E_NG :異常終了
E_PRM :パラメータエラー(APからのCドライブを指定した場合)
≪備考≫
【異常終了要因】 ①ファイル/パス名異常(使用不可コード混在)
②パス長異常(128文字以上の指定)
③指定ドライブ未フォーマット
④指定ドライブ未搭載
⑤ドライブ指定外(D以上)
⑥ファイル未検出
⑦指定ファイルが無い