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 |