CmGetBoundTransaction function (wdm.h)

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

See also

CmRegisterCallback

CmRegisterCallbackEx

RegistryCallback