Fonction ZwQueryKey (wdm.h)

Article
02/29/2024

La routine ZwQueryKey fournit des informations sur la classe d’une clé de Registre, ainsi que sur le nombre et les tailles de ses sous-clés.

Syntaxe

NTSYSAPI NTSTATUS ZwQueryKey(
  [in]            HANDLE                KeyHandle,
  [in]            KEY_INFORMATION_CLASS KeyInformationClass,
  [out, optional] PVOID                 KeyInformation,
  [in]            ULONG                 Length,
  [out]           PULONG                ResultLength
);

Paramètres

[in] KeyHandle

Gérez la clé de Registre pour obtenir des informations sur. Ce handle est créé par un appel réussi à ZwCreateKey ou ZwOpenKey.

[in] KeyInformationClass

Spécifie une valeur KEY_INFORMATION_CLASS qui détermine le type d’informations retournées dans la mémoire tampon KeyInformation .

[out, optional] KeyInformation

Pointeur vers une mémoire tampon allouée à l’appelant qui reçoit les informations demandées.

[in] Length

Spécifie la taille, en octets, de la mémoire tampon KeyInformation .

[out] ResultLength

Pointeur vers une variable qui reçoit la taille, en octets, des informations de clé demandées. Si ZwQueryKey retourne STATUS_SUCCESS, la variable contient la quantité de données retournées. Si ZwQueryKey retourne STATUS_BUFFER_OVERFLOW ou STATUS_BUFFER_TOO_SMALL, vous pouvez utiliser la valeur de la variable pour déterminer la taille de mémoire tampon requise.

Valeur retournée

ZwQueryKey retourne STATUS_SUCCESS en cas de réussite ou le code d’erreur approprié en cas d’échec. Les valeurs de code d’erreur possibles sont les suivantes :

Code de retour	Description
STATUS_BUFFER_OVERFLOW	La mémoire tampon fournie est trop petite et seules des données partielles ont été écrites dans la mémoire tampon. *ResultLength est défini sur la taille minimale requise pour contenir les informations demandées.
STATUS_BUFFER_TOO_SMALL	La mémoire tampon fournie est trop petite et aucune donnée n’a été écrite dans la mémoire tampon. *ResultLength est défini sur la taille minimale requise pour contenir les informations demandées.
STATUS_INVALID_PARAMETER	Le paramètre KeyInformationClass n’est pas une valeur KEY_INFORMATION_CLASS valide.

Remarques

Le KeyHandle passé à ZwQueryKey doit avoir été ouvert avec KEY_QUERY_VALUE accès. Pour ce faire, transmettez KEY_QUERY_VALUE, KEY_READ ou KEY_ALL_ACCESS en tant que paramètre DesiredAccess à ZwCreateKey ou ZwOpenKey.

Si KeyInformationClass est KeyNameInformation ou KeyHandleTagsInformation, l’exigence KEY_QUERY_VALUE ne s’applique pas.

ZwQueryKey peut être utilisé pour obtenir des informations que vous pouvez utiliser pour allouer des mémoires tampons pour contenir des données du Registre, telles que la taille maximale des entrées de valeur ou des noms de sous-clés d’une clé, ou le nombre de sous-clés. Par exemple, vous pouvez appeler ZwQueryKey, utiliser les informations retournées pour allouer une mémoire tampon pour une sous-clé, appeler ZwEnumerateKey pour obtenir le nom de la sous-clé et passer ce nom à une routine rtlXxxRegistry .

Pour plus d’informations sur l’utilisation des clés de Registre, consultez Utilisation du Registre dans un pilote.

Si l’appel à cette fonction se produit en mode utilisateur, vous devez utiliser le nom « NtQueryKey » au lieu de « ZwQueryKey ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport),IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport),ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)