estrutura REG_QUERY_KEY_NAME (wdm.h)

Artigo
07/02/2025

A estrutura REG_QUERY_KEY_NAME descreve o nome completo da chave do registro de um objeto que está sendo consultado.

Sintaxe

C++

typedef struct _REG_QUERY_KEY_NAME {
  PVOID                    Object;
  POBJECT_NAME_INFORMATION ObjectNameInfo;
  ULONG                    Length;
  PULONG                   ReturnLength;
  PVOID                    CallContext;
  PVOID                    ObjectContext;
  PVOID                    Reserved;
} REG_QUERY_KEY_NAME, *PREG_QUERY_KEY_NAME;

Membros

Object

Um ponteiro para o objeto de chave do Registro para a chave cujos metadados estão prestes a ser consultados.

ObjectNameInfo

Um ponteiro para uma estrutura de OBJECT_NAME_INFORMATION (consulte wdm.h) que contém o nome completo da chave do Registro a ser retornado pelo sistema, como uma cadeia de caracteres Unicode.

Length

Especifica o tamanho, em bytes, do buffer ObjectNameInfo.

ReturnLength

CallContext

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

ObjectContext

Um ponteiro para informações de contexto definidas pelo driver que o driver associou a um objeto do Registro chamando CmSetCallbackObjectContext. Ele contém o contexto de chave para a chave que está sendo consultada.

Reserved

Esse membro é reservado para uso futuro.

Observações

O sistema passa essa estrutura para a rotina de RegistryCallback sempre que um thread tenta consultar o nome completo da chave do Registro.

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 10 e versões posteriores do sistema operacional Windows.
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Consulte também

REG_NOTIFY_CLASS

RegistryCallback

Partilhar via