Fonction RtlQueryRegistryValueWithFallback (ntddk.h)
Récupère une entrée de valeur pour une clé de Registre à l’aide d’un handle principal ; si elle est introuvable, utilise la poignée 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 la mémoire tampon ValueData requise pour contenir les informations de données.
Valeur retournée
Retourne STATUS_SUCCESS en cas de réussite ou le code d’erreur approprié en cas d’échec.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1809 |
| En-tête | ntddk.h (include wdm.h) |
| Bibliothèque | NtosKrnl.lib |
| IRQL | PASSIVE_LEVEL |