Función CmRegisterCallback (wdm.h)

  • Artículo

La rutina CmRegisterCallback está obsoleta para Windows Vista y versiones posteriores del sistema operativo. En su lugar, use CmRegisterCallbackEx .

La rutina CmRegisterCallback registra una rutina RegistryCallback .

Sintaxis

NTSTATUS CmRegisterCallback(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie
);

Parámetros

[in] Function

Puntero a la rutina RegistryCallback que se va a registrar.

[in, optional] Context

Valor definido por el controlador que el administrador de configuración pasará como parámetro CallbackContext a la rutina RegistryCallback .

[out] Cookie

Puntero a una variable LARGE_INTEGER que recibe el valor que identifica la rutina de devolución de llamada. Al anular el registro de la rutina de devolución de llamada, pase este valor como parámetro Cookie a CmUnRegisterCallback.

Valor devuelto

CmRegisterCallback devuelve STATUS_SUCCESS si la operación se realiza correctamente o el código de error NTSTATUS adecuado si se produce un error.

Comentarios

La rutina CmRegisterCallback está disponible en Windows XP y versiones posteriores del sistema operativo. En el caso de Windows Vista y versiones posteriores del sistema operativo, debe usar CmRegisterCallbackEx en su lugar.

Un controlador llama a CmRegisterCallback para registrar una rutina RegistryCallback , a la que se llama cada vez que un subproceso realiza una operación en el registro.

Llame a CmUnRegisterCallback para anular el registro de una rutina de devolución de llamada registrada por CmRegisterCallback .

Para obtener más información sobre las operaciones del Registro de filtrado y CmRegisterCallback , consulte Filtrado de llamadas al Registro.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows XP y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <=APC_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm)

Consulte también

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback