Fonction RtlCreateRegistryKey (wdm.h)

Article
02/29/2024

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