RtlQueryRegistryValueWithFallback-Funktion (ntddk.h)
Ruft einen Werteintrag für einen Registrierungsschlüssel mit einem primären Handle ab. wenn nicht gefunden, verwendet das Fallbackhandle.
Syntax
NTSYSAPI NTSTATUS RtlQueryRegistryValueWithFallback(
[in] HANDLE PrimaryHandle,
[in] HANDLE FallbackHandle,
[in] PUNICODE_STRING ValueName,
[in] ULONG ValueLength,
[Out] PULONG ValueType,
[out] PVOID ValueData,
[out] PULONG ResultLength
);
Parameter
[in] PrimaryHandle
Das Handle für den Schlüssel, der zuerst zum Abfragen der Werteinträge verwendet wird. Dieses Handle wird durch einen erfolgreichen Aufruf von ZwCreateKey oder ZwOpenKey erstellt.
[in] FallbackHandle
Das Handle, das zum Abfragen des Schlüssels verwendet werden soll, wenn der Wert nicht mithilfe des von PrimaryHandle angegebenen Handle gefunden wird.
[in] ValueName
Ein Zeiger auf eine Zeichenfolge, der den Namen des Werts enthält, für den Daten abgerufen werden sollen.
[in] ValueLength
Gibt die Größe der ValueName-Zeichenfolge in Bytes an.
[Out] ValueType
Ein Zeiger auf eine ULONG-Variable, die den Typ des abgefragten Werts empfängt.
[out] ValueData
Ein Zeiger auf einen Puffer, der die Wertdaten empfängt.
[out] ResultLength
Ein Zeiger auf eine Variable, die die Wertdatengröße in Bytes empfängt. Wenn der Rückgabewert STATUS_SUCCESS ist, gibt die Anzahl der Bytes an, die in den ValueData-Puffer geschrieben wurden. Wenn der Aufruf STATUS_BUFFER_OVERFLOW zurückgibt, gibt die Anzahl der erforderlichen Bytes an. Aufrufer können diesen Wert verwenden, um die Größe des ValueData-Puffers zu bestimmen, der für die Dateninformationen erforderlich ist.
Rückgabewert
Gibt STATUS_SUCCESS bei Erfolg oder den entsprechenden Fehlercode bei Einem Fehler zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1809 |
| Kopfzeile | ntddk.h (einschließen von wdm.h) |
| Bibliothek | NtosKrnl.lib |
| IRQL | PASSIVE_LEVEL |