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

Weitere Informationen

Verwenden der Registrierung in einem Treiber