estrutura REG_LOAD_KEY_INFORMATION (wdm.h)

Artigo
08/08/2023

A estrutura REG_LOAD_KEY_INFORMATION contém informações sobre um hive do Registro que está sendo carregado.

Sintaxe

typedef struct _REG_LOAD_KEY_INFORMATION {
  PVOID           Object;
  PUNICODE_STRING KeyName;
  PUNICODE_STRING SourceFile;
  ULONG           Flags;
  PVOID           TrustClassObject;
  PVOID           UserEvent;
  ACCESS_MASK     DesiredAccess;
  PHANDLE         RootHandle;
  PVOID           CallContext;
  PVOID           ObjectContext;
  PVOID           Reserved;
} REG_LOAD_KEY_INFORMATION, *PREG_LOAD_KEY_INFORMATION;

Membros

Object

Um ponteiro para o objeto de chave do Registro para a chave raiz do hive que está prestes a ser carregado.

KeyName

Um ponteiro para uma estrutura UNICODE_STRING que contém o nome da chave raiz.

SourceFile

Um ponteiro para uma estrutura UNICODE_STRING que contém o nome do caminho de um arquivo que contém as informações de hive do registro que estão sendo carregadas.

Flags

Reservado para uso do sistema.

TrustClassObject

Reservado para uso do sistema.

UserEvent

Um ponteiro para um objeto de evento que é sinalizado quando o hive é descarregado.

DesiredAccess

A máscara de acesso especificada pelo thread que está tentando carregar a chave do Registro. Para obter mais informações sobre essa máscara de acesso, consulte a descrição do parâmetro DesiredAccess da rotina ZwCreateKey .

RootHandle

Um ponteiro opcional para um local que recebe o identificador para a raiz do hive que está sendo carregado. Esse membro poderá ser não NULL se um hive de aplicativo estiver sendo carregado. Em todos os outros casos, esse membro deve ser NULL.

CallContext

Informações de contexto opcionais definidas pelo driver que a rotina RegistryCallback do driver pode fornecer.

ObjectContext

Um ponteiro para informações de contexto definidas pelo driver que o driver associou a um objeto do Registro chamando a rotina CmSetCallbackObjectContext .

Reserved

Reservado para uso do sistema.

Comentários

O sistema operacional passa a estrutura REG_LOAD_KEY_INFORMATION para uma rotina RegistryCallback sempre que um thread no modo de usuário chama RegLoadKey para carregar um hive do Registro.

Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas do Registro.