Estrutura de REG_QUERY_KEY_INFORMATION (WDM. h)

A estrutura de REG_QUERY_KEY_INFORMATION descreve os metadados que estão prestes a serem consultados para 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ções a serem retornadas 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 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 opcionais de contexto definidas por driver que a rotina RegistryCallback do driver pode fornecer. esse membro é definido para Windows Vista e versões posteriores do sistema operacional Windows.

ObjectContext

Um ponteiro para informações de contexto definidas por driver que o driver associou a um objeto do registro chamando CmSetCallbackObjectContext. esse membro é definido para Windows Vista e versões posteriores do sistema operacional Windows.

Reserved

Este membro é reservado para uso futuro. esse membro é definido para Windows Vista e versões posteriores do sistema operacional Windows.

Comentários

O sistema passa essa estrutura para a rotina RegistryCallback toda vez que um thread tenta consultar os metadados de uma chave — por exemplo, quando um thread do 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 Filtering Registry calls.

Requisitos

Cliente mínimo com suporte	disponível no Microsoft Windows XP e em versões posteriores do sistema operacional Windows.
Cabeçalho	WDM. h (incluir WDM. h, Ntddk. h, Ntifs. h)

Confira também

CmSetCallbackObjectContext

RegistryCallback

ZwQueryKey