struttura REG_UNLOAD_KEY_INFORMATION (wdm.h)

  • Articolo

La struttura REG_UNLOAD_KEY_INFORMATION contiene informazioni che la routine RegistryCallback di un driver può usare quando viene scaricato un hive del Registro di sistema.

Sintassi

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

Members

Object

Puntatore a un oggetto chiave del Registro di sistema. Questo oggetto rappresenta la chiave radice dell'hive che viene scaricata.

UserEvent

Puntatore a un oggetto evento.

CallContext

Informazioni di contesto definite dal driver facoltative che la routine RegistryCallback del driver può fornire. Questo membro viene definito a partire da Windows Vista.

ObjectContext

Puntatore a informazioni di contesto definite dal driver associate a un oggetto del Registro di sistema chiamando CmSetCallbackObjectContext. Questo membro viene definito a partire da Windows Vista.

Reserved

Questo membro è riservato per usi futuri. Questo membro viene definito a partire da Windows Vista.

Commenti

Questa struttura viene usata dalla routine RegistryCallback . Quando il parametro Argument1 della routine RegistryCallback è RegNtPreUnloadKey, il parametro Argument2 è un puntatore a una struttura REG_UNLOAD_KEY_INFORMATION .

Il sistema operativo passa la struttura REG_UNLOAD_KEY_INFORMATION alla routine RegistryCallback ogni volta che un thread tenta di scaricare una chiave, ad esempio quando un thread in modalità utente chiama la funzione RegUnloadKey . In risposta a una notifica RegNtPreUnloadKey , la routine RegistryCallback deve liberare qualsiasi risorsa precedentemente allocata per l'uso con l'hive prima del caricamento dell'hive.

Per altre informazioni sulle operazioni di filtro del Registro di sistema, vedere Filtro delle chiamate del Registro di sistema.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows Vista.
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Vedi anche

CmSetCallbackObjectContext

RegistryCallback