struttura REG_UNLOAD_KEY_INFORMATION (wdm.h)
La struttura REG_UNLOAD_KEY_INFORMATION contiene informazioni che è possibile utilizzare routine RegistryCallback di un driver 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;
Membri
Object
Puntatore a un oggetto chiave del Registro di sistema. Questo oggetto rappresenta la chiave radice dell'hive da scaricare.
UserEvent
Puntatore a un oggetto evento.
CallContext
Informazioni di contesto facoltative definite dal driver che il driver RegistryCallback routine può fornire. Questo membro viene definito a partire da Windows Vista.
ObjectContext
Puntatore alle informazioni sul 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 un uso futuro. Questo membro viene definito a partire da Windows Vista.
Osservazioni
Questa struttura viene utilizzata 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 di RegNtPreUnloadKey, la routine RegistryCallback deve liberare qualsiasi risorsa allocata in precedenza per l'uso con l'hive prima che l'hive venga scaricato.
Per altre informazioni sulle operazioni di filtro del Registro di sistema, vedere Filtro delle chiamate del Registro di sistema.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows Vista. |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |