Partager via


Fonction RtlWriteRegistryValue (wdm.h)

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

Voir aussi

RtlCheckRegistryKey

RtlCreateRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

ZwCreateKey

ZwOpenKey

ZwSetValueKey