estrutura REG_QUERY_KEY_INFORMATION (wdm.h)
A estrutura REG_QUERY_KEY_INFORMATION descreve os metadados que estão prestes a ser consultados para obter uma chave.
Sintaxe
typedef struct _REG_QUERY_KEY_INFORMATION {
PVOID Object;
KEY_INFORMATION_CLASS KeyInformationClass;
PVOID KeyInformation;
ULONG Length;
PULONG ResultLength;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_QUERY_KEY_INFORMATION, *PREG_QUERY_KEY_INFORMATION;
Membros
Object
Um ponteiro para o objeto de chave do Registro para a chave cujos metadados estão prestes a ser consultados.
KeyInformationClass
O valor KEY_INFORMATION_CLASS que indica o tipo de informação a ser retornado pelo sistema.
KeyInformation
Um ponteiro para um buffer que contém as informações a serem retornadas pelo sistema. O formato do buffer depende do valor de KeyInformationClass. Para obter mais informações, consulte KEY_INFORMATION_CLASS.
Length
Especifica o tamanho, em bytes, do buffer de KeyInformation.
ResultLength
Ponteiro para uma variável que recebe (do sistema) a quantidade de dados válidos, em bytes, no buffer KeyInformation.
CallContext
Informações de contexto definidas pelo driver opcionais que a rotina de registryCallback do driver podem fornecer. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.
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 para o Windows Vista e versões posteriores do sistema operacional Windows.
Reserved
Esse membro é reservado para uso futuro. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.
Observações
O sistema passa essa estrutura para a rotina RegistryCallback sempre que um thread tenta consultar os metadados de uma chave, por exemplo, quando um thread no modo de usuário chama RegQueryInfoKey ou quando um driver chama ZwQueryKey.
Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas de registro.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e versões posteriores do sistema operacional Windows. |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |