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)

Consulte también

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback