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)

Confira também

CmSetCallbackObjectContext

RegistryCallback

ZwDeleteKey

ZwQueryValueKey