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 |