FindFirstFileTransactedW

指定された名前に一致するファイルまたはサブディレクトリをディレクトリから検索する処理をトランザクション操作として実行する。(Unicode)

FindFirstFileTransactedW lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags, hTransaction

lpFileName : [wstr] ディレクトリまたはパスとファイル名。ファイル名にはワイルドカード文字（たとえばアスタリスク (*) や疑問符 (?)）を含めることができる。このパラメータは NULL、無効な文字列（たとえば空文字列や終端 NULL 文字を欠いた文字列）、または末尾のバックスラッシュ (\\) で終わる文字列であってはならない。文字列がワイルドカード、ピリオド (.)、またはディレクトリ名で終わる場合、ユーザーはルートとパス上のすべてのサブディレクトリにアクセスできる必要がある。この関数の ANSI 版では名前は MAX_PATH 文字までに制限される。この制限を 32,767 ワイド文字まで拡張するには、関数の Unicode 版を呼び出してパスの先頭に "\\?\" を付加する。詳細は Naming a File を参照。ファイルはローカルコンピュータ上に存在しなければならない。そうでない場合、関数は失敗し最後のエラーコードは ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE に設定される。
fInfoLevelId : [int] 返されるデータの情報レベル。
lpFindFileData : [intptr] 見つかったファイルやサブディレクトリに関する情報を受け取る WIN32_FIND_DATA 構造体へのポインタ。
fSearchOp : [int] ワイルドカードマッチング以外で実行するフィルタリングの種類。
lpSearchFilter : [intptr] 指定された fSearchOp が構造化された検索情報を必要とする場合の検索条件へのポインタ。
dwAdditionalFlags : [int] 検索を制御する追加フラグを指定する。
hTransaction : [intptr] トランザクションへのハンドル。このハンドルは CreateTransaction 関数が返す。

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

解説

指定された名前に一致するファイルまたはサブディレクトリをディレクトリから検索する処理をトランザクション操作として実行する。(Unicode)

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

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

情報