Freigeben über


NtQueryMultipleValueKey-Funktion (winternl.h)

[Diese Funktion kann ohne weitere Ankündigung geändert oder aus Windows entfernt werden.]

Ruft Werte für den angegebenen mehrwertigen Schlüssel ab.

Syntax

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

Parameter

[in] KeyHandle

Ein Handle für den Schlüssel, für den Werte abgerufen werden sollen. Das Handle muss mit dem Zugriffsrecht KEY_QUERY_VALUE geöffnet werden.

[in, out] ValueEntries

Ein Zeiger auf ein Array von [KEY_VALUE_ENTRY]-Strukturen, die die Namen der abzurufenden Werte enthalten.

[in] EntryCount

Die Anzahl der Elemente im ValueEntries-Array .

[out] ValueBuffer

Ein Zeiger auf einen Puffer zum Empfangen der Werte.

[in, out] BufferLength

Ein Zeiger auf eine Variable, die die Größe des Puffers bei ValueBuffer in Bytes enthält. Wenn die Funktion zurückgibt, enthält der Parameter BufferLength die Anzahl der Bytes, die bei ValueBuffer in den Puffer geschrieben werden.

[out, optional] RequiredBufferLength

Ein Zeiger auf eine Variable, um die Anzahl der Bytes zu empfangen, die für alle von der Funktion zurückgegebenen Werte erforderlich sind. Dieser Parameter kann NULL sein.

Rückgabewert

Gibt einen NTSTATUS - oder Fehlercode zurück.

Wenn der Puffer zu klein ist, um die abzurufenden Informationen zu speichern, gibt die Funktion STATUS_BUFFER_OVERFLOW zurück. Wenn der RequiredBufferLength-Parameter angegeben ist, wird er auf die erforderliche Puffergröße festgelegt.

Die Formen und die Bedeutung von NTSTATUS-Fehlercodes sind in der Im WDK verfügbaren Ntstatus.h-Headerdatei aufgeführt und in der WDK-Dokumentation beschrieben.

Hinweise

Diese Funktion verfügt über keine zugeordnete Headerdatei. Sie können auch die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Ntdll.dll zu verknüpfen.

Anforderungen

   
Zielplattform Windows
Kopfzeile winternl.h
Bibliothek ntdll.lib
DLL ntdll.dll

Weitere Informationen

Sicherheits- und Zugriffsrechte für Registrierungsschlüssel