CmGetBoundTransaction function (wdm.h)

Article
02/22/2024

The CmGetBoundTransaction routine returns a pointer to the transaction object that represents the transaction, if any, that is associated with a specified registry key object.

Syntax

PVOID CmGetBoundTransaction(
  [in] PLARGE_INTEGER Cookie,
  [in] PVOID          Object
);

Parameters

[in] Cookie

The cookie value that the driver previously obtain by calling CmRegisterCallback or CmRegisterCallbackEx.

[in] Object

The pointer value that the driver's RegistryCallback callback routine received in one of the REG_XXX_KEY_INFORMATION structures.

Return value

CmGetBoundTransaction returns a pointer to a transaction object, if the key object that the Object parameter specifies is associated with a transaction. Otherwise, the routine returns NULL.

Remarks

The CmGetBoundTransaction routine is available on Windows Vista and later versions of Windows.

For more information about CmGetBoundTransaction and filtering registry operations, see Filtering Registry Calls.

For more information about transactions, see Kernel Transaction Manager Design Guide.

Requirements

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