Método IRegistryKey::QueryRegistryValues (portcls.h)
O QueryRegistryValues método 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 QueryRegistryValues método chamará com informações sobre a entrada do Registro correspondente. A matriz deve ser encerrada por uma estrutura com um membro Name que seja NULL.
[in, optional] Context
Esse é um valor de contexto definido pelo chamador. O QueryRegistryValues método 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 a QueryRoutine do chamador acessa. O valor de contexto é convertido no tipo de ponteiro PVOID, mas o QueryRegistryValues método não executa nenhuma validação do ponteiro.
Retornar valor
QueryRegistryValues retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida no processamento de toda a QueryTable. 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 |
|---|---|
|
Indica que o parâmetro QueryTable que foi passado para o método não é válido. |
|
Indica que o método não pôde localizar o objeto especificado em uma das entradas queryTable . |
Comentários
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 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 |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | portcls.h (inclua Portcls.h) |
| IRQL | PASSIVE_LEVEL |