Fonction RtlCreateRegistryKey (wdm.h)
La routine RtlCreateRegistryKey ajoute un objet clé dans le Registre le long d’un chemin relatif donné.
Syntaxe
NTSYSAPI NTSTATUS RtlCreateRegistryKey(
[in] ULONG RelativeTo,
[in] PWSTR Path
);
Paramètres
[in] RelativeTo
Spécifie si Path est un chemin d’accès absolu au Registre ou s’il est relatif à un chemin de clé prédéfini comme l’un des éléments suivants.
| Valeur | Signification |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Path est un chemin d’accès absolu au Registre. |
| RTL_REGISTRY_SERVICES | Le chemin d’accès est relatif à \Registry\Machine\System\CurrentControlSet\Services. |
| RTL_REGISTRY_CONTROL | Le chemin d’accès est relatif à \Registry\Machine\System\CurrentControlSet\Control. |
| RTL_REGISTRY_WINDOWS_NT | Le chemin d’accès est relatif à \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion. |
| RTL_REGISTRY_DEVICEMAP | Le chemin d’accès est relatif à \Registry\Machine\Hardware\DeviceMap. |
| RTL_REGISTRY_USER | Le chemin d’accès est relatif à \Registry\User\CurrentUser. (Pour un processus système, il s’agit de \Users\. Par défaut.) |
[in] Path
Spécifie le chemin d’accès du Registre en fonction de la valeur RelativeTo .
Valeur retournée
RtlCreateRegistryKey retourne STATUS_SUCCESS si la clé est créée.
Remarques
RtlCreateRegistryKey crée uniquement les clés que vous spécifiez. Il ne crée pas de clés manquantes dans le chemin d’accès à la clé spécifiée. Si des clés du chemin d’accès sont manquantes, l’appel échoue. Pour vous assurer que toutes les clés du chemin existent, vous devez appeler RtlCreateRegistryKey une fois pour chaque clé du chemin.
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 (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |