FindFirstFileNameTransactedW 関数 (winbase.h)
[Microsoft では、開発者がアプリケーションのニーズを達成するために代替手段を利用することを強くお勧めします。 TxF が開発された多くのシナリオは、よりシンプルで利用しやすい手法で実現できます。 また、将来のバージョンの Microsoft Windows では TxF を使用できない場合があります。 詳細、および TxF の代替手段については、「トランザクション NTFS の使用の代替手段」を参照してください。]
トランザクション操作として、指定したファイルへのすべてのハード リンクの列挙を作成します。 この関数は、FindNextFileNameW 関数の後続の呼び出しで使用できる列挙へのハンドルを返します。
構文
HANDLE FindFirstFileNameTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName,
[in, optional] HANDLE hTransaction
);
パラメーター
[in] lpFileName
ファイルの名前です。
ファイルはローカル コンピューターに存在する必要があります。それ以外の場合、関数は失敗し、最後のエラー コードは ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805) に設定されます。
[in] dwFlags
予約;0 を指定します。
[in, out] StringLength
LinkName パラメーターが指すバッファーのサイズ (文字数)。 この呼び出しが失敗し、エラーが ERROR_MORE_DATA (234) の場合、このパラメーターによって返される値は、 LinkName が指すバッファーがすべてのデータを格納する必要があるサイズです。
[in, out] LinkName
lpFileName で見つかった最初のリンク名を格納するバッファーへのポインター。
[in, optional] hTransaction
トランザクションのハンドル。 このハンドルは、 CreateTransaction 関数によって返されます。
戻り値
関数が成功した場合、戻り値は FindNextFileNameW 関数で使用したり、 FindClose 関数で閉じたりできる検索ハンドルです。
関数が失敗した場合、戻り値は INVALID_HANDLE_VALUE (0xffffffff)。 終了
拡張エラー情報を取得し、 GetLastError 関数を呼び出します。
解説
Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。
| テクノロジ | サポートされています |
|---|---|
| サーバー メッセージ ブロック (SMB) 3.0 プロトコル | いいえ |
| SMB 3.0 Transparent Failover (TFO) | いいえ |
| スケールアウト ファイル共有 (SO) を使う SMB 3.0 | いいえ |
| クラスターの共有ボリューム ファイル システム (CsvFS) | いいえ |
| Resilient File System (ReFS) | いいえ |
SMB 3.0 は TxF をサポートしていません。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |