Edit

TRANSACTION_PROPERTIES_INFORMATION structure (wdm.h)

  • Article

The TRANSACTION_PROPERTIES_INFORMATION structure contains a transaction object's properties.

Syntax

typedef struct _TRANSACTION_PROPERTIES_INFORMATION {
  ULONG         IsolationLevel;
  ULONG         IsolationFlags;
  LARGE_INTEGER Timeout;
  ULONG         Outcome;
  ULONG         DescriptionLength;
  WCHAR         Description[1];
} TRANSACTION_PROPERTIES_INFORMATION, *PTRANSACTION_PROPERTIES_INFORMATION;

Members

IsolationLevel

Reserved for future use.

IsolationFlags

Reserved for future use.

Timeout

A time-out value. If the transaction has not been committed by the time specified by this parameter, KTM rolls back the transaction. The time-out value is expressed in system time units (100-nanosecond intervals), and can specify either an absolute time or a relative time. If the value of the Timeout member is negative, the expiration time is relative to the current system time. Otherwise, the expiration time is absolute. Set this member to zero if no time-out is required. If Timeout is zero, the transaction never times out.

Outcome

A TRANSACTION_OUTCOME-typed value that identifies the transaction's outcome (result). You can obtain this value by calling ZwQueryInformationTransaction, but you cannot set the value with ZwSetInformationTransaction.

DescriptionLength

The size, in bytes, of the buffer that contains the Description member's array.

Description[1]

A caller-allocated array of characters that contains or receives the transaction's description string. The TPS client can specify this string when it calls ZwCreateTransaction. The client can retrieve the string by calling by calling ZwQueryInformationTransaction, and it can modify the string by calling ZwSetInformationTransaction.

Remarks

The TRANSACTION_PROPERTIES_INFORMATION structure is used with the ZwQueryInformationTransaction and ZwSetInformationTransaction routines.

Requirements

Requirement Value
Minimum supported client Available starting with Windows Vista.
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

See also

TRANSACTION_INFORMATION_CLASS

TRANSACTION_OUTCOME

ZwCreateTransaction

ZwQueryInformationTransaction

ZwSetInformationTransaction