Partager via


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