Funzione RtlQueryRegistryValueWithFallback (ntddk.h)

Articolo
02/26/2024

Recupera una voce di valore per una chiave del Registro di sistema usando un handle primario; se non trovato, usa l'handle di fallback.

Sintassi

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

Parametri

[in] PrimaryHandle

Handle alla chiave usata per eseguire una query sulle voci del valore. Questo handle viene creato da una chiamata riuscita a ZwCreateKey o ZwOpenKey.

[in] FallbackHandle

Handle da usare per eseguire query sulla chiave se il valore non viene trovato usando l'handle specificato da PrimaryHandle.

[in] ValueName

Puntatore a stringa contenente il nome del valore per cui recuperare i dati.

[in] ValueLength

Specifica le dimensioni, in byte, della stringa ValueName .

[Out] ValueType

Puntatore a una variabile ULONG che riceve il tipo del valore sottoposto a query.

[out] ValueData

Puntatore a un buffer che riceve i dati del valore.

[out] ResultLength

Puntatore a una variabile che riceve le dimensioni dei dati del valore, in byte. Se il valore restituito è STATUS_SUCCESS, indica il numero di byte scritti nel buffer ValueData . Se la chiamata restituisce STATUS_BUFFER_OVERFLOW, indica il numero di byte necessari. I chiamanti possono usare tale valore per determinare le dimensioni del buffer ValueData necessario per contenere le informazioni sui dati.

Valore restituito

Restituisce STATUS_SUCCESS in caso di esito positivo o il codice di errore appropriato in caso di errore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1809
Intestazione	ntddk.h (include wdm.h)
Libreria	NtosKrnl.lib
IRQL	PASSIVE_LEVEL

Vedi anche

Uso del Registro di sistema in un driver

Condividi tramite