TmIsTransactionActive function (wdm.h)

The TmIsTransactionActive routine indicates whether a specified transaction is in its active state.

Syntax

BOOLEAN TmIsTransactionActive(
  [in] PKTRANSACTION Transaction
);

Parameters

[in] Transaction

A pointer to a transaction object. To obtain this pointer, your component must call ObReferenceObjectByHandle and supply the object handle that a previous call to ZwCreateTransaction or ZwOpenTransaction provided.

Return value

TmIsTransactionActive returns TRUE if the specified transaction is in its active state. Otherwise, the routine returns FALSE.

Remarks

When a transaction is created, it enters its active state and remains in that state until the pre-prepare/prepare/commit sequence begins.

For more information about TmIsTransactionActive, and for information about when to use KTM's TmXxx routines instead of ZwXxx routines, see Using TmXxx Routines.

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later operating system versions.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Any level

See also

ObReferenceObjectByHandle

ZwCreateTransaction

ZwOpenTransaction