Compartir a través de


estructura REG_UNLOAD_KEY_INFORMATION (wdm.h)

La estructura de REG_UNLOAD_KEY_INFORMATION contiene información que la rutina RegistryCallback 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 RegistryCallback del controlador. 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 se reserva para uso futuro. Este miembro se define a partir de Windows Vista.

Comentarios

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

El sistema operativo pasa la estructura REG_UNLOAD_KEY_INFORMATION a la rutina RegistryCallback 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 RegNtPreUnloadKey , la rutina RegistryCallback debe liberar los recursos que el controlador haya asignado previamente para su uso con el subárbol 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 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

RegistryCallback