Compartir a través de


estructura REG_UNLOAD_KEY_INFORMATION (wdm.h)

La estructura REG_UNLOAD_KEY_INFORMATION contiene información que la rutina registryCall back de un controlador puede usar cuando se descarga un subárbol del Registro.

Sintaxis

typedef struct _REG_UNLOAD_KEY_INFORMATION {
  PVOID Object;
  PVOID UserEvent;
  PVOID CallContext;
  PVOID ObjectContext;
  PVOID Reserved;
} REG_UNLOAD_KEY_INFORMATION, *PREG_UNLOAD_KEY_INFORMATION;

Miembros

Object

Puntero a un objeto de clave del Registro. Este objeto representa la clave raíz del subárbol que se está descargando.

UserEvent

Puntero a un objeto de evento.

CallContext

Información de contexto opcional definida por el controlador que puede proporcionar la rutina registryCall back del controlador RegistryCallback. Este miembro se define a partir de Windows Vista.

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. Este miembro se define a partir de Windows Vista.

Reserved

Este miembro está reservado para uso futuro. Este miembro se define a partir de Windows Vista.

Observaciones

Esta estructura la usa la rutina de RegistryCallback. Cuando el parámetro argument1 de al registryCallback rutina es RegNtPreUnloadKey, el parámetro Argument2 es un puntero a una estructura de REG_UNLOAD_KEY_INFORMATION.

El sistema operativo pasa la estructura REG_UNLOAD_KEY_INFORMATION a la RegistryCallback rutina cada vez que un subproceso intenta descargar una clave, por ejemplo, cuando un subproceso en modo de usuario llama a la función RegUnloadKey. En respuesta a una notificación de RegNtPreUnloadKey, la rutina RegistryCallback debe liberar los recursos asignados anteriormente para su uso con hive antes de descargar el subárbol.

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

registryCallback