Função NtQueryMultipleValueKey (winternl.h)

[Essa função pode ser alterada ou removida do Windows sem aviso prévio.]

Recupera valores para a chave de vários valores especificada.

Sintaxe

__kernel_entry NTSTATUS NtQueryMultipleValueKey(
  [in]            HANDLE           KeyHandle,
  [in, out]       PKEY_VALUE_ENTRY ValueEntries,
  [in]            ULONG            EntryCount,
  [out]           PVOID            ValueBuffer,
  [in, out]       PULONG           BufferLength,
  [out, optional] PULONG           RequiredBufferLength
);

Parâmetros

[in] KeyHandle

Um identificador para a chave para a qual recuperar valores. O identificador deve ser aberto com o direito de acesso KEY_QUERY_VALUE .

[in, out] ValueEntries

Um ponteiro para uma matriz de estruturas [KEY_VALUE_ENTRY] que contém os nomes dos valores a serem recuperados.

[in] EntryCount

O número de elementos na matriz ValueEntries .

[out] ValueBuffer

Um ponteiro para um buffer para receber os valores.

[in, out] BufferLength

Um ponteiro para uma variável que contém o tamanho do buffer em ValueBuffer, em bytes. Quando a função retorna, o parâmetro BufferLength contém o número de bytes gravados no buffer em ValueBuffer.

[out, optional] RequiredBufferLength

Um ponteiro para uma variável para receber o número de bytes necessários para que todos os valores sejam retornados pela função. Este parâmetro pode ser NULL.

Retornar valor

Retorna um código de erro ou NTSTATUS .

Se o buffer for muito pequeno para conter as informações a serem recuperadas, a função retornará STATUS_BUFFER_OVERFLOW e, se o parâmetro RequiredBufferLength for especificado, o definirá como o tamanho do buffer necessário.

Os formulários e a significância dos códigos de erro NTSTATUS estão listados no arquivo de cabeçalho Ntstatus.h disponível no WDK e são descritos na documentação do WDK.

Comentários

Essa função não tem nenhum arquivo de cabeçalho associado. Você também pode usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Ntdll.dll.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	winternl.h
Biblioteca	ntdll.lib
DLL	ntdll.dll

Confira também

Direitos de segurança e acesso de chave do Registro