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 メンバーである必要があります。 |