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

関連項目

File Management 関数

FindClose

FindNextFileNameW

トランザクション NTFS