CmRegisterCallback routine

The CmRegisterCallback routine is obsolete for Windows Vista and later operating system versions. Use CmRegisterCallbackEx instead.

The CmRegisterCallback routine registers a RegistryCallback routine.

Syntax


NTSTATUS CmRegisterCallback(
  _In_      PEX_CALLBACK_FUNCTION Function,
  _In_opt_  PVOID Context,
  _Out_     PLARGE_INTEGER Cookie
);

Parameters

Function [in]

A pointer to the RegistryCallback routine to register.

Context [in, optional]

A driver-defined value that the configuration manager will pass as the CallbackContext parameter to the RegistryCallback routine

Cookie [out]

A pointer to a LARGE_INTEGER variable that receives the value that identifies the callback routine. When you unregister the callback routine, pass this value as the Cookie parameter to CmUnRegisterCallback.

Return value

CmRegisterCallback returns STATUS_SUCCESS if the operation succeeds or the appropriate NTSTATUS error code if it fails.

Remarks

The CmRegisterCallback routine is available on Windows XP and later operating system versions. For Windows Vista and later operating system versions, you should use CmRegisterCallbackEx instead.

A driver calls CmRegisterCallback to register a RegistryCallback routine, which is called every time a thread performs an operation on the registry.

Call CmUnRegisterCallback to unregister a callback routine that CmRegisterCallback registered.

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

Requirements

Version

Available in Windows XP and later versions of Windows.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<=APC_LEVEL

DDI compliance rules

IrqlExApcLte2, HwStorPortProhibitedDDIs

See also

RegistryCallback
CmRegisterCallbackEx
CmUnRegisterCallback

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft