TxF Control Codes

[Microsoft strongly recommends developers utilize alternative means to achieve your application’s needs. Many scenarios that TxF was developed for can be achieved through simpler and more readily available techniques. Furthermore, TxF may not be available in future versions of Microsoft Windows. For more information, and alternatives to TxF, please see Alternatives to using Transactional NTFS.]

Transactional NTFS (TxF) provides the following control codes.

In this section

Control CodeDescription

FSCTL_TXFS_CREATE_MINIVERSION

Creates a new miniversion for the specified file.

Miniversions allow you to refer to a snapshot of the file during a transaction. Miniversions are discarded when a transaction is committed or rolled back.

FSCTL_TXFS_GET_METADATA_INFO

Retrieves Transacted NTFS (TxF) metadata for a file and the GUID of the transaction that has locked the specified file (if the file is locked).

FSCTL_TXFS_GET_TRANSACTED_VERSION

Returns a TXFS_GET_TRANSACTED_VERSION structure. The structure identifies the most recently committed version of the specified file, the version number of the handle.

FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES

Returns a list of all files currently locked by the specified transaction. If the return value is ERROR_MORE_DATA, it returns the length of the buffer required to hold the complete list of files at the time of this call.

FSCTL_TXFS_LIST_TRANSACTIONS

Returns a list of all the transactions currently involved in the specified resource manager.

FSCTL_TXFS_MODIFY_RM

Sets the log mode and log parameter information for a secondary resource manager (RM).

FSCTL_TXFS_QUERY_RM_INFORMATION

Retrieves information for a resource manager (RM).

FSCTL_TXFS_READ_BACKUP_INFORMATION

Returns Transactional NTFS (TxF) specific information for the specified file.

FSCTL_TXFS_SAVEPOINT_INFORMATION

The FSCTL_TXFS_SAVEPOINT_INFORMATION control code controls setting, clearing, and rolling back to the specified savepoint.

To perform this operation, call the DeviceIoControl function with the following parameters.

FSCTL_TXFS_TRANSACTION_ACTIVE

Returns a Boolean value that indicates if there were any transactions active on the associated volume when the snapshot was taken. This call is only valid for read-only snapshot volumes.

FSCTL_TXFS_WRITE_BACKUP_INFORMATION

Writes Transactional NTFS (TxF) specific information to a specified file. The Buffer member of the TXFS_WRITE_BACKUP_INFORMATION structure must be the Buffer member of the TXFS_READ_BACKUP_INFORMATION_OUT structure returned by FSCTL_TXFS_READ_BACKUP_INFORMATION.

 

 

 

Show: