TxF の制御コード

[Microsoft では、開発者がアプリケーションのニーズを達成するために代替手段を利用することを強くお勧めします。 TxF が開発された多くのシナリオは、よりシンプルで簡単に利用できる手法によって実現できます。 さらに、将来のバージョンの Microsoft Windows では TxF を使用できない場合があります。 詳細と TxF の代替方法については、「 トランザクション NTFS を使用するための代替手段」を参照してください。

トランザクション NTFS (TxF) には、次の制御コードが用意されています。

このセクションの内容

制御コード	説明
FSCTL_TXFS_CREATE_MINIVERSION	指定したファイルの新しい ミニバージョン を作成します。 ミニバージョンを使用すると、トランザクション中にファイルのスナップショットを参照できます。 トランザクションがコミットまたはロールバックされると、ミニバージョンは破棄されます。
FSCTL_TXFS_GET_METADATA_INFO	ファイルの Transacted NTFS (TxF) メタデータと、指定したファイルをロックしたトランザクションの GUID を取得します (ファイルがロックされている場合)。
FSCTL_TXFS_GET_TRANSACTED_VERSION	TXFS_GET_TRANSACTED_VERSION構造体を返します。 構造体は、指定したファイルの最後にコミットされたバージョン (ハンドルのバージョン番号) を識別します。
FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES	指定したトランザクションによって現在ロックされているすべてのファイルの一覧を返します。 戻り値が ERROR_MORE_DATA場合、この呼び出し時にファイルの完全なリストを保持するために必要なバッファーの長さを返します。
FSCTL_TXFS_LIST_TRANSACTIONS	指定したリソース マネージャーに現在関係しているすべてのトランザクションの一覧を返します。
FSCTL_TXFS_MODIFY_RM	セカンダリ リソース マネージャー (RM) のログ モードとログ パラメーター情報を設定します。
FSCTL_TXFS_QUERY_RM_INFORMATION	リソース マネージャー (RM) の情報を取得します。
FSCTL_TXFS_READ_BACKUP_INFORMATION	指定したファイルのトランザクション NTFS (TxF) 固有の情報を返します。
FSCTL_TXFS_SAVEPOINT_INFORMATION	FSCTL_TXFS_SAVEPOINT_INFORMATION コントロール コードは、指定したセーブポイントの設定、クリア、ロールバックを制御します。 この操作を実行するには、次のパラメーターを使用して DeviceIoControl 関数を呼び出します。
FSCTL_TXFS_TRANSACTION_ACTIVE	スナップショットが取得されたときに、関連付けられたボリュームでアクティブなトランザクションがあったかどうかを示すブール値を返します。 この呼び出しは、読み取り専用スナップショットボリュームでのみ有効です。
FSCTL_TXFS_WRITE_BACKUP_INFORMATION	トランザクション NTFS (TxF) 固有の情報を指定したファイルに書き込みます。 TXFS_WRITE_BACKUP_INFORMATION構造体の Buffer メンバーは、FSCTL_TXFS_READ_BACKUP_INFORMATIONによって返されるTXFS_READ_BACKUP_INFORMATION_OUT構造体の Buffer メンバーである必要があります。