FindFirstStreamTransactedW

指定されたファイルやディレクトリ内の最初のストリームをトランザクション操作として列挙する。

FindFirstStreamTransactedW lpFileName, InfoLevel, lpFindStreamData, dwFlags, hTransaction

lpFileName : [wstr] 完全修飾ファイル名。ファイルはローカルコンピュータ上に存在しなければならない。そうでない場合、関数は失敗し最後のエラーコードは ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805) に設定される。
InfoLevel : [int] 返されるデータの情報レベル。このパラメータは STREAM_INFO_LEVELS 列挙型の値の 1 つである。
lpFindStreamData : [intptr] ファイルデータを受け取るバッファへのポインタ。このデータの形式は InfoLevel パラメータの値に依存する。
dwFlags : [int] 将来の使用のために予約。このパラメータは 0 でなければならない。
hTransaction : [intptr] トランザクションへのハンドル。このハンドルは CreateTransaction 関数が返す。

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

解説

指定されたファイルやディレクトリ内の最初のストリームをトランザクション操作として列挙する。

[戻り値]
関数が成功した場合、戻り値は FindNextStreamW
関数の以降の呼び出しで使用できる検索ハンドルである。関数が失敗した場合、戻り値は INVALID_HANDLE_VALUE
となる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
すべてのファイルにはデフォルトのデータストリームがある。NTFS では、ファイルは 1
つ以上の名前付きデータストリームを持つこともできる。FAT
ファイルシステムでは、ファイルはデフォルトのデータストリーム以外を持つことができないため、この関数は FAT
ファイルシステムのファイルに対して使用しても有効な結果を返さない。この関数はハードリンクをサポートするすべてのファイルシステムで動作する。それ以外の場合、関数は
ERROR_STATUS_NOT_IMPLEMENTED (6805) を返す。FindFirstStreamTransactedW
関数は検索ハンドルを開き、指定されたファイルやディレクトリ内の最初のストリームに関する情報を返す。ファイルの場合、これは常にデフォルトデータストリーム
::$DATA となる。検索ハンドルが確立されたら、FindNextStreamW
関数で指定されたファイルやディレクトリ内の他のストリームを検索するために使用する。検索ハンドルが不要になったら、FindClose
関数を使って閉じる必要がある。Windows 8 および Windows Server 2012
では、この関数は次の技術でサポートされる。
（以下省略）

情報