Método IRegistryKey::QueryRegistryValues (portcls.h)

Artigo
02/07/2025

O método QueryRegistryValues permite que o chamador consulte vários valores do Registro com uma única chamada.

Sintaxe

NTSTATUS QueryRegistryValues(
  [in]           PRTL_QUERY_REGISTRY_TABLE QueryTable,
  [in, optional] PVOID                     Context
);

Parâmetros

[in] QueryTable

Ponteiro para uma matriz de uma ou mais estruturas RTL_QUERY_REGISTRY_TABLE. (Essa estrutura é descrita em RtlQueryRegistryValues.) Cada estrutura especifica o nome do valor e o nome da subchave para uma entrada do Registro que o chamador está consultando. Cada estrutura também contém um ponteiro de função para um retorno de chamada queryRoutine fornecido pelo chamador que o método QueryRegistryValues chamará com informações sobre a entrada do Registro correspondente. A matriz deve ser encerrada por uma estrutura com um membro NameNULL.

[in, optional] Context

Esse é um valor de contexto definido pelo chamador. O método QueryRegistryValues passa esse valor como um parâmetro de chamada para cada um dos retornos de chamada queryRoutine. O valor de contexto normalmente é um ponteiro para uma estrutura definida pelo chamador que contém dados de contexto que o queryRoutine do chamador acessa. O valor de contexto é convertido no tipo de ponteiro PVOID, mas o método QueryRegistryValues não executa nenhuma validação do ponteiro.

Valor de retorno

QueryRegistryValues retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida no processamento de todo o deQueryTable. Caso contrário, o método retornará um código de erro apropriado. A tabela a seguir mostra alguns dos possíveis códigos de status de retorno.

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Indica que o parâmetro QueryTable que foi passado para o método não é válido.
STATUS_OBJECT_NAME_NOT_FOUND	Indica que o método não pôde localizar o objeto especificado em uma das entradas QueryTable.

Observações

Esse método usa rotinas de retorno de chamada fornecidas pelo chamador para enumerar os valores de uma lista de entradas do Registro. Se tiver êxito, o método retornará depois de chamar todas as rotinas de retorno de chamada na lista.

O parâmetro QueryTable aponta para uma matriz de estruturas de RTL_QUERY_REGISTRY_TABLE. O primeiro membro dessa estrutura, queryRoutine, é um ponteiro de função para uma rotina de retorno de chamada fornecida pelo chamador. Para obter mais informações, consulte RtlQueryRegistryValues.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	portcls.h (inclua Portcls.h)
IRQL	PASSIVE_LEVEL

Consulte também

IRegistryKey

rtlQueryRegistryValues

Partilhar via