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

Voir aussi

Utilisation du Registre dans un pilote