estructura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION (wdm.h)
La estructura de REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION contiene información que la rutina RegistryCallback de un controlador puede usar para liberar recursos asignados previamente al contexto asociado a un objeto de registro.
Sintaxis
typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION {
PVOID Object;
PVOID ObjectContext;
PVOID Reserved;
} REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION;
Miembros
Object
Puntero al objeto de clave del Registro para que se elimine la clave.
ObjectContext
Puntero a la información de contexto definida por el controlador que el controlador ha asociado a un objeto del Registro llamando a CmSetCallbackObjectContext.
Reserved
Este miembro se reserva para uso futuro.
Comentarios
Esta estructura la usa la rutina RegistryCallback . Cuando el parámetro Argument1 de la rutina RegistryCallback es RegNtCallbackObjectContextCleanup, el parámetro Argument2 es un puntero a una estructura de REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION .
La rutina RegistryCallback del controlador recibirá una notificación RegNtCallbackObjectContextCleanup cuando el recuento de referencias del objeto de clave cae a cero (es decir, no hay identificadores pendientes ni referencias de puntero al objeto de clave).
En respuesta a esta notificación, la rutina debe liberar los recursos asignados para el contexto del objeto. La notificación RegNtCallbackObjectContextCleanup se produce cuando el controlador ha llamado a CmUnRegisterCallback o la rutina RegistryCallback del controlador acaba de terminar de procesar una notificación RegNtPreKeyHandleClose .
Para obtener más información sobre las operaciones de filtrado del registro, consulte Filtrado de llamadas del Registro.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows Vista. |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |