Fonction RtlCheckRegistryKey (wdm.h)

La routine RtlCheckRegistryKey vérifie l’existence d’une clé nommée donnée dans le Registre.

Syntaxe

NTSYSAPI NTSTATUS RtlCheckRegistryKey(
  [in] ULONG RelativeTo,
  [in] PWSTR Path
);

Paramètres

[in] RelativeTo

Spécifie si Path est un chemin d’accès de Registre absolu ou s’il est relatif à un chemin de clé prédéfini comme suit.

Valeur	Signification
RTL_REGISTRY_ABSOLUTE	Path est un chemin d’accès absolu au Registre.
RTL_REGISTRY_CONTROL	Le chemin d’accès est relatif à \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_DEVICEMAP	Le chemin d’accès est relatif à \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_SERVICES	Le chemin d’accès est relatif à \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_USER	Le chemin d’accès est relatif aux paramètres de Registre de l’utilisateur actuel. (Pour un processus système, il s’agit de \Users\. Par défaut.) Cela équivaut à HKEY_CURRENT_USER en mode utilisateur.
RTL_REGISTRY_WINDOWS_NT	Le chemin d’accès est relatif à \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_HANDLE	Cette valeur ne doit pas être passée dans cette routine. Malgré la redondance d’un case activée pour l’existence d’une clé déjà ouverte, elle a pour effet secondaire de fermer le handle passé.

[in] Path

Spécifie le chemin du Registre en fonction de la valeur RelativeTo . Si RTL_REGISTRY_HANDLE est défini, Path est un handle à utiliser directement.

Valeur retournée

Si la clé nommée donnée existe dans le Registre le long du chemin d’accès relatif donné, RtlCheckRegistryKey retourne STATUS_SUCCESS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Voir aussi

RtlQueryRegistryValues