Export (0) Print
Expand All

TXFS_GET_TRANSACTED_VERSION structure

[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.]

Contains the information about the base and latest versions of the specified file.

Syntax


typedef struct _TXFS_GET_TRANSACTED_VERSION {
  ULONG  ThisBaseVersion;
  ULONG  LatestVersion;
  USHORT ThisMiniVersion;
  USHORT FirstMiniVersion;
  USHORT LatestMiniVersion;
} TXFS_GET_TRANSACTED_VERSION, *PTXFS_GET_TRANSACTED_VERSION;

Members

ThisBaseVersion

The version of the file that this handle is opened with. This member can be one of the following values.

ValueMeaning
TXFS_TRANSACTED_VERSION_NONTRANSACTED
0xFFFFFFFE

The file is not a transacted file.

TXFS_TRANSACTED_VERSION_UNCOMMITTED
0xFFFFFFFF

The file has been opened as a transacted writer.

 

If the handle has been opened as a transacted reader, the value returned for this member is a positive integer that represents the version number of the file the handle is associated with.

LatestVersion

The most recently committed version of the file.

ThisMiniVersion

If the handle to a miniversion is open, this member contains the ID of the miniversion. If the handle is not open, this member is zero (0).

FirstMiniVersion

The first available miniversion for this file. If there are no miniversions, or they are not visible to the transaction bound to the file handle, this field is zero (0).

LatestMiniVersion

The latest available miniversion for this file. If there are no miniversions, or they are not visible to the transaction bound to the file handle, this field is zero (0).

Remarks

The base version number remains the same for the lifetime of a handle. The latest version number increases as long as a handle is still open to a file and a change is committed. When the handle is closed, the version number is reset to zero.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

WinIoCtl.h (include Windows.h)

See also

FSCTL_TXFS_GET_TRANSACTED_VERSION

 

 

Community Additions

ADD
Show:
© 2014 Microsoft