estrutura REG_QUERY_VALUE_KEY_INFORMATION (wdm.h)
A estrutura REG_QUERY_VALUE_KEY_INFORMATION contém informações sobre a entrada de valor de uma chave do Registro que está sendo consultada.
Sintaxe
typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
PVOID Object;
PUNICODE_STRING ValueName;
KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
PVOID KeyValueInformation;
ULONG Length;
PULONG ResultLength;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;
Membros
Object
Um ponteiro para o objeto de chave do Registro para a chave cuja entrada de valor está sendo consultada.
ValueName
Um ponteiro para uma estrutura UNICODE_STRING que contém o nome da entrada de valor para a qual recuperar informações.
KeyValueInformationClass
O valor KEY_VALUE_INFORMATION_CLASS que indica o tipo de informação a ser retornado pelo sistema.
KeyValueInformation
Um ponteiro para um buffer que contém as informações a serem retornadas pelo sistema. O formato do buffer depende do valor de KeyValueInformationClass. Para obter mais informações , consulte KEY_VALUE_INFORMATION_CLASS.
Length
O tamanho, em bytes, do buffer KeyValueInformation .
ResultLength
Um ponteiro para uma variável que recebe (do sistema) a quantidade de dados válidos, em bytes, no buffer KeyValueInformation .
CallContext
Informações de contexto opcionais definidas pelo driver que a rotina RegistryCallback do driver pode 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
Este membro é reservado para uso futuro. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.
Comentários
O sistema passa essa estrutura para uma rotina RegistryCallback sempre que um thread tenta consultar uma entrada de valor para uma chave, por exemplo, quando um thread no modo de usuário chama RegQueryValue ou RegQueryValueEx ou quando um driver chama ZwDeleteKey.
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 no Microsoft Windows XP e versões posteriores do sistema operacional Windows. |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |