RtlQueryRegistryValueWithFallback-Funktion (ntddk.h)

Ruft einen Werteintrag für einen Registrierungsschlüssel mithilfe eines primären Handles ab; wenn nicht gefunden, wird das Fallbackhandle verwendet.

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 ZwOpenKeyerstellt.

[in] FallbackHandle

Das Handle zum Abfragen des Schlüssels, wenn der Wert nicht mithilfe des durch PrimaryHandleangegebenen Handle gefunden wird.

[in] ValueName

Ein Zeiger auf eine Zeichenfolge, die den Namen des Werts enthält, für den Daten abgerufen werden sollen.

[in] ValueLength

Gibt die Größe der ValueName- Zeichenfolge in Byte 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 Byte 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 ValueData- Puffers zu bestimmen, der zum Speichern der Dateninformationen erforderlich ist.

Rückgabewert

Gibt STATUS_SUCCESS bei Erfolg oder den entsprechenden Fehlercode für Fehler zurück.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1809
Header-	ntddk.h (include wdm.h)
Library	NtosKrnl.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

Verwenden der Registrierung in einem Treiber-