struttura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION (wdm.h)
La struttura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION contiene informazioni che la routine RegistryCallback di un driver può usare per liberare risorse allocate in precedenza dal driver per il contesto associato a un oggetto del Registro di sistema.
Sintassi
typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION {
PVOID Object;
PVOID ObjectContext;
PVOID Reserved;
} REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION;
Members
Object
Puntatore all'oggetto chiave del Registro di sistema per la chiave da eliminare.
ObjectContext
Puntatore alle informazioni sul contesto definite dal driver associate a un oggetto del Registro di sistema chiamando CmSetCallbackObjectContext.
Reserved
Questo membro è riservato per usi futuri.
Commenti
Questa struttura viene utilizzata dalla routine RegistryCallback . Quando il parametro Argument1 della routine RegistryCallback è RegNtCallbackObjectContextCleanup, il parametro Argument2 è un puntatore a una struttura REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION .
La routine RegistryCallback del driver riceverà una notifica RegNtCallbackObjectContextCleanup quando il conteggio dei riferimenti dell'oggetto chiave scende a zero,ad esempio non sono presenti handle o riferimenti puntatori in sospeso all'oggetto chiave.
In risposta a questa notifica, la routine deve rilasciare tutte le risorse allocate per il contesto dell'oggetto. La notifica RegNtCallbackObjectContextCleanup si verifica quando il driver ha chiamato CmUnRegisterCallback o la routine RegistryCallback del driver ha appena terminato l'elaborazione di una notifica RegNtPreKeyHandleClose .
Per altre informazioni sulle operazioni di filtro del Registro di sistema, vedere Filtro delle chiamate al 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) |