Fonction RtlWriteRegistryValue (wdm.h)

Article
02/27/2024

La routine RtlWriteRegistryValue écrit les données fournies par l’appelant dans le registre le long du chemin relatif spécifié au nom de la valeur donnée.

Syntaxe

NTSYSAPI NTSTATUS RtlWriteRegistryValue(
  [in]           ULONG  RelativeTo,
  [in]           PCWSTR Path,
  [in]           PCWSTR ValueName,
  [in]           ULONG  ValueType,
  [in, optional] PVOID  ValueData,
  [in]           ULONG  ValueLength
);

Paramètres

[in] RelativeTo

Spécifie si path est un chemin de Registre absolu ou est relatif à un chemin prédéfini comme suit.

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.)
RTL_REGISTRY_OPTIONAL	Spécifie que la clé référencée par ce paramètre et le paramètre Path sont facultatifs.
RTL_REGISTRY_HANDLE	Spécifie que le paramètre Path est en fait un handle de Registre à utiliser. Cette valeur est facultative.

[in] Path

Pointeur vers un chemin de Registre absolu ou un chemin relatif à l’emplacement connu spécifié par le paramètre RelativeTo . Si l’indicateur RTL_REGISTRY_HANDLE est spécifié, ce paramètre est un handle de Registre pour une clé déjà ouverte à utiliser directement.

[in] ValueName

Pointeur vers le nom d’une sous-clé ou d’une entrée de valeur à écrire dans le Registre.

[in] ValueType

Spécifie une valeur REG_XXX qui détermine le type du paramètre ValueName . Pour obtenir la liste des valeurs possibles, consultez le paramètre Type de ZwSetValueKey.

[in, optional] ValueData

Pointeur vers le nom d’une sous-clé ou des valeurs pour ses entrées de valeur (ou les deux) à écrire dans le Registre.

[in] ValueLength

Spécifie le nombre d’octets de ValueData à écrire dans le Registre.

Valeur retournée

RtlWriteRegistryValue retourne le status de l’opération, soit STATUS_SUCCESS, soit une erreur status.

Remarques

Si la clé spécifiée n’existe pas, la routine tente de créer la clé. Pour que cette tentative aboutisse, la nouvelle clé doit être une sous-clé directe de la clé référencée par le paramètre Path , et la clé à laquelle path fait référence doit avoir été ouverte pour l’accès KEY_CREATE_SUB_KEY.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
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