estrutura REG_UNLOAD_KEY_INFORMATION (wdm.h)

  • Artigo

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)

Confira também

CmSetCallbackObjectContext

RegistryCallback