Funzione RtlQueryRegistryValueWithFallback (ntddk.h)

Articolo
02/07/2025

Recupera una voce di valore per una chiave del Registro di sistema utilizzando un handle primario; se non viene 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 per la chiave usata per la prima volta per eseguire query sulle voci di 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 alla stringa contenente il nome del valore per il quale 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 di ValueData buffer 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1809
intestazione	ntddk.h (include wdm.h)
libreria	NtosKrnl.lib
IRQL	PASSIVE_LEVEL

Vedere anche

Uso del Registro di sistema in un driver

Condividi tramite