AIT_FindFirstFile

機能

ファイル検索ハンドルを開いて,指定したファイル名と名前が一致する最初のファイル名を返します。

形式

bool AIT_FindFirstFile  (
 string strFileNamePattern,    // ファイル名
 string strFileName,           // 検索されたファイル名
 integer nSearchHandle         // ファイル検索ハンドル
);

引数

strFileNamePattern(入力用)

有効なディレクトリの名前,パスまたはファイル名を指定してください。ワイルドカード(*)も使用できます。文字列がワイルドカード,ピリオド,またはディレクトリ名で終わる場合,ユーザはルートまたはパス上のすべてのサブディレクトリへのアクセス権を持っている必要があります。

strFileName(出力用)

指定したファイル名と一致する,検索されたファイルの名前を受け取る変数を指定してください。関数から制御が戻ると,この変数に検索されたファイルの名前が格納されます。

nSearchHandle(出力用)

AIT_FindNextFileおよびAIT_FindCloseFileへの後続の検索で使用するファイル検索ハンドルを受け取る変数を指定してください。関数から制御が戻ると,この変数にファイル検索ハンドルが格納されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue,そのほかの場合はfalseとなります。関数がfalseを返した場合には,AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返す可能性のあるエラーコードを次に示します。

拡張エラー番号エラーコード
2ERROR_FILE_NOT_FOUND
3ERROR_PATH_NOT_FOUND
5ERROR_ACCESS_DENIED
6ERROR_INVALID_HANDLE
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
18ERROR_NO_MORE_FILES
21ERROR_NOT_READY
112ERROR_DISK_FULL
123ERROR_INVALID_NAME
148ERROR_PATH_BUSY
1005ERROR_UNRECOGNIZED_VOLUME
1210ERROR_INVALID_COMPUTERNAME
1214ERROR_INVALID_NETNAME
1231ERROR_NETWORK_UNREACHABLE

注意事項