Partager via


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

Voir aussi

RtlCheckRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey