TXFS_LIST_TRANSACTION_LOCKED_FILES_ENTRY structure (winioctl.h)

[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 information about a locked transaction.

Syntax

typedef struct _TXFS_LIST_TRANSACTION_LOCKED_FILES_ENTRY {
  DWORDLONG Offset;
  DWORD     NameFlags;
  LONGLONG  FileId;
  DWORD     Reserved1;
  DWORD     Reserved2;
  LONGLONG  Reserved3;
  WCHAR     FileName[1];
} TXFS_LIST_TRANSACTION_LOCKED_FILES_ENTRY, *PTXFS_LIST_TRANSACTION_LOCKED_FILES_ENTRY;

Members

Offset

The offset, in bytes, from the beginning of the TXFS_LIST_TRANSACTION_LOCKED_FILES structure to the next TXFS_LIST_TRANSACTION_LOCKED_FILES_ENTRY.

NameFlags

Indicates whether the current name was deleted or created in the current transaction. Note that both flags may appear if the name was both created and deleted in the same transaction. In that case, the FileName member will contain only an empty string with a terminating null character ("\0") because there is no meaningful name to report.

TXFS_LIST_TRANSACTION_LOCKED_FILES_ENTRY_FLAG_CREATED (0x00000001)

TXFS_LIST_TRANSACTION_LOCKED_FILES_ENTRY_FLAG_DELETED (0x00000002)

FileId

The NTFS File ID of the file.

Reserved1

Reserved. Specify zero.

Reserved2

Reserved. Specify zero.

Reserved3

Reserved. Specify zero.

FileName[1]

The path to the file, relative to the volume root. The file name is a NULL-terminated Unicode string.

Requirements

Requirement Value
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_LIST_TRANSACTION_LOCKED_FILES

TXFS_LIST_TRANSACTION_LOCKED_FILES