FindFirstFileExW

指定された名前と属性に一致するファイルまたはサブディレクトリをディレクトリから検索する。(FindFirstFileExW)

FindFirstFileExW lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags

lpFileName : [wstr] ディレクトリまたはパスとファイル名。ファイル名にはワイルドカード文字（たとえばアスタリスク (*) や疑問符 (?)）を含めることができる。このパラメータは NULL、無効な文字列（たとえば空文字列や終端 NULL 文字を欠いた文字列）、または末尾のバックスラッシュ (\\) で終わる文字列であってはならない。文字列がワイルドカード、ピリオド、またはディレクトリ名で終わる場合、ユーザーはルートとパス上のすべてのサブディレクトリにアクセスできる必要がある。この関数の ANSI 版では名前は MAX_PATH 文字までに制限される。この制限を約 32,000 ワイド文字まで拡張するには、関数の Unicode 版 (FindFirstFileExW) を呼び出してパスの先頭に "\\\\?\\" を付加する。詳細は Naming a File を参照。ヒント: Windows 10 バージョン 1607 以降、この関数の Unicode 版 (FindFirstFileExW) では、"\\?\" を付けずに MAX_PATH 文字制限を取り除くオプトインができる。詳細は Naming Files, Paths, and Namespaces の "Maximum Path Limitation" セクションを参照。
fInfoLevelId : [int] 返されるデータの情報レベル。
lpFindFileData : [intptr] ファイルデータを受け取るバッファへのポインタ。
fSearchOp : [int] ワイルドカードマッチング以外で実行するフィルタリングの種類。
lpSearchFilter : [intptr] 指定された fSearchOp が構造化された検索情報を必要とする場合の検索条件へのポインタ。
dwAdditionalFlags : [int] 検索を制御する追加フラグを指定する。

(プラグイン / モジュール : kernel32.dll)

解説

指定された名前と属性に一致するファイルまたはサブディレクトリをディレクトリから検索する。(FindFirstFileExW)

[戻り値]
関数が成功した場合、戻り値は FindNextFile または FindClose
の以降の呼び出しで使用される検索ハンドルであり、lpFindFileData
パラメータには見つかった最初のファイルまたはディレクトリに関する情報が含まれる。関数が失敗するか、lpFileName
パラメータの検索文字列からファイルを見つけられない場合、戻り値は INVALID_HANDLE_VALUE
となり、lpFindFileData の内容は不定となる。拡張エラー情報を取得するには GetLastError 関数を呼ぶ。

[備考]
FindFirstFileEx
関数は検索ハンドルを開き、指定されたパターンに一致する名前を持つ最初のファイルに関する情報をファイルシステムが見つけたものとして返す。これは、同じファイル名文字列パターンが与えられたときに
dir コマンドのようなディレクトリ列挙アプリケーションに表示される最初のファイルやディレクトリと一致する場合もしないこともある。これは
FindFirstFileEx が検索結果のソートを行わないためである。詳細は FindNextFile
を参照。次のリストはその他の検索特性を示す。
（以下省略）

情報