Compartir a través de


estructura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION (wdm.h)

La estructura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION contiene información que el controlador RegistryCallback rutina puede usar para liberar recursos asignados previamente para el 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 la clave que se va a eliminar.

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 está reservado para uso futuro.

Observaciones

Esta estructura la usa la rutina de RegistryCallback. Cuando el parámetro Argument1 a la rutina RegistryCallback de es RegNtCallbackObjectContextCleanup, el parámetro Argument2 es un puntero a una estructura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION.

La rutina de RegistryCallback del controlador recibirá una notificación RegNtCallbackObjectContextCleanup cuando el recuento de referencias del objeto de clave pasa 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 del controlador RegistryCallback acaba 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 Valor
cliente mínimo admitido Disponible a partir de Windows Vista.
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

CmSetCallbackObjectContext

CmUnRegisterCallback

registryCallback