1 out of 1 rated this helpful - Rate this topic

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

C++


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