Condividi tramite


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 le 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;

Membri

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 un uso futuro.

Osservazioni

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 notifica 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 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)

Vedere anche

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback