estrutura REG_UNLOAD_KEY_INFORMATION (wdm.h)
A estrutura REG_UNLOAD_KEY_INFORMATION contém informações que a rotina RegistryCallback de um driver pode usar quando um hive do registro é descarregado.
Sintaxe
typedef struct _REG_UNLOAD_KEY_INFORMATION {
PVOID Object;
PVOID UserEvent;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_UNLOAD_KEY_INFORMATION, *PREG_UNLOAD_KEY_INFORMATION;
Membros
Object
Um ponteiro para um objeto de chave do Registro. Esse objeto representa a chave raiz do hive que está sendo descarregado.
UserEvent
Um ponteiro para um objeto de evento.
CallContext
Informações de contexto opcionais definidas pelo driver que a rotina RegistryCallback do driver pode fornecer. Esse membro é definido a partir do Windows Vista.
ObjectContext
Um ponteiro para informações de contexto definidas pelo driver que o driver associou a um objeto do Registro chamando CmSetCallbackObjectContext. Esse membro é definido a partir do Windows Vista.
Reserved
Este membro é reservado para uso futuro. Esse membro é definido a partir do Windows Vista.
Comentários
Essa estrutura é usada pela rotina RegistryCallback . Quando o parâmetro Argument1 para a rotina RegistryCallback é RegNtPreUnloadKey, o parâmetro Argument2 é um ponteiro para uma estrutura REG_UNLOAD_KEY_INFORMATION .
O sistema operacional passa a estrutura REG_UNLOAD_KEY_INFORMATION para a rotina RegistryCallback sempre que um thread tenta descarregar uma chave, por exemplo, quando um thread no modo de usuário chama a função RegUnloadKey . Em resposta a uma notificação RegNtPreUnloadKey , a rotina RegistryCallback deve liberar todos os recursos que o driver alocou anteriormente para uso com o hive antes que o hive seja descarregado.
Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas do Registro.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows Vista. |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |