RtlQueryRegistryValueWithFallback, fonction (ntddk.h)

Article
02/07/2025

Récupère une entrée de valeur pour une clé de Registre à l’aide d’un handle principal ; s’il n’est pas trouvé, utilise le handle de secours.

Syntaxe

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

Paramètres

[in] PrimaryHandle

Handle de la clé utilisée pour la première fois pour interroger les entrées de valeur. Ce handle est créé par un appel réussi à ZwCreateKey ou ZwOpenKey.

[in] FallbackHandle

Handle à utiliser pour interroger la clé si la valeur est introuvable à l’aide du handle spécifié par PrimaryHandle.

[in] ValueName

Pointeur vers la chaîne qui contient le nom de la valeur pour laquelle récupérer des données.

[in] ValueLength

Spécifie la taille, en octets, de la chaîne ValueName.

[Out] ValueType

Pointeur vers une variable ULONG qui reçoit le type de la valeur interrogée.

[out] ValueData

Pointeur vers une mémoire tampon qui reçoit les données de valeur.

[out] ResultLength

Pointeur vers une variable qui reçoit la taille des données de valeur, en octets. Si la valeur de retour est STATUS_SUCCESS, indique le nombre d’octets écrits dans la mémoire tampon ValueData. Si l’appel retourne STATUS_BUFFER_OVERFLOW, indique le nombre d’octets requis. Les appelants peuvent utiliser cette valeur pour déterminer la taille de mémoire tampon ValueData requise pour contenir les informations de données.

Valeur de retour

Retourne STATUS_SUCCESS en cas de réussite ou le code d’erreur approprié en cas d’échec.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1809
d’en-tête	ntddk.h (include wdm.h)
bibliothèque	NtosKrnl.lib
IRQL	PASSIVE_LEVEL

Voir aussi

utiliser le Registre dans un de pilote

Partager via