Funzione NtQueryMultipleValueKey (winternl.h)

Articolo
02/01/2024

[Questa funzione può essere modificata o rimossa da Windows senza ulteriore preavviso.]

Recupera i valori per la chiave a più valori specificata.

Sintassi

__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
);

Parametri

[in] KeyHandle

Handle per la chiave per cui recuperare i valori. L'handle deve essere aperto con il diritto di accesso KEY_QUERY_VALUE .

[in, out] ValueEntries

Puntatore a una matrice di strutture [KEY_VALUE_ENTRY] contenenti i nomi dei valori da recuperare.

[in] EntryCount

Numero di elementi nella matrice ValueEntries .

[out] ValueBuffer

Puntatore a un buffer per ricevere i valori.

[in, out] BufferLength

Puntatore a una variabile che contiene le dimensioni del buffer in ValueBuffer, in byte. Quando la funzione viene restituita, il parametro BufferLength contiene il numero di byte scritti nel buffer in ValueBuffer.

[out, optional] RequiredBufferLength

Puntatore a una variabile per ricevere il numero di byte necessari per la restituzione di tutti i valori dalla funzione. Questo parametro può essere NULL.

Valore restituito

Restituisce un codice NTSTATUS o di errore.

Se il buffer è troppo piccolo per contenere le informazioni da recuperare, la funzione restituisce STATUS_BUFFER_OVERFLOW e, se viene specificato il parametro RequiredBufferLength , lo imposta sulla dimensione del buffer richiesta.

Le forme e il significato dei codici di errore NTSTATUS sono elencati nel file di intestazione Ntstatus.h disponibile in WDK e sono descritti nella documentazione di WDK.

Commenti

Questa funzione non ha alcun file di intestazione associato. È anche possibile usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Ntdll.dll.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	winternl.h
Libreria	ntdll.lib
DLL	ntdll.dll

Vedi anche

Diritti di accesso e sicurezza delle chiavi del Registro di sistema

Condividi tramite