Aide:RegWrite.txt

Document original V3.3.6.1 :

###Function###
RegWrite

###Description###
Creates a key or value in the registry.

###Syntax###
RegWrite ( "keyname" [,"valuename" [, "type" [, value]]] )


###Parameters###
@@ParamTable@@
keyname
	The registry key to write to.  If no other parameters are specified this key will simply be created.
valuename
	[optional] The valuename to write to.
type
	[optional] Type of key to write: "REG_SZ", "REG_MULTI_SZ", "REG_EXPAND_SZ", "REG_DWORD", "REG_QWORD", or "REG_BINARY".
value
	[optional] The value to write.
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Failure:	Returns 0 if error writing registry key or value.
	 @error can be set to following values :
	 1 if unable to open requested key
	 2 if unable to open requested main key
	 3 if unable to remote connect to the registry
	-1 if unable to open requested value
	-2 if value type not supported
@@End@@


###Remarks###
A registry key must start with "HKEY_LOCAL_MACHINE" ("HKLM") or "HKEY_USERS" ("HKU") or "HKEY_CURRENT_USER" ("HKCU") or "HKEY_CLASSES_ROOT" ("HKCR") or "HKEY_CURRENT_CONFIG" ("HKCC").

When running on 64-bit Windows if you want to write a key or value specific to the 64-bit environment you have to suffix the HK... with 64 i.e. HKLM64.

AutoIt supports registry keys of type REG_BINARY, REG_SZ, REG_MULTI_SZ, REG_EXPAND_SZ, REG_QWORD, and REG_DWORD.

To access the <b>(Default)</b> value use <b>""</b> (a blank string) for the valuename.

When writing a REG_MULTI_SZ key you must separate each value with @LF.  The value must NOT end with @LF unless you want ant empty substring (see example).

It is possible to access remote registries by using a keyname in the form "\\computername\keyname".  To use this feature you must have the correct access rights on NT/2000/XP/2003.


###Related###
RegDelete, RegRead, RegEnumKey, RegEnumVal


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
RegWrite

###Description###
Crée une clé ou une valeur dans le registre.

###Syntax###
RegWrite ( "keyname" [,"valuename" [, "type" [, value]]] )


###Parameters###
@@ParamTable@@
keyname
	La clé de registre à écrire. Si aucun autres paramètres sont spécifiés cette clé sera simplement créé.
valuename
	[optionnel] Le nom de la valeur à écrire.
type
	[optionnel] Type de clé à écrire: "REG_SZ", "REG_MULTI_SZ", "REG_EXPAND_SZ", "REG_DWORD", "REG_QWORD", ou "REG_BINARY".
value
	[optionnel] La valeur à écrire.
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès:	Retourne 1.
Échec:	Retourne 0 si il y a une erreur d'écriture dans la clé de registres ou dans la valeur.
	@error peut être défini sur les valeurs suivantes:
	1 En cas d'impossibilité d'ouvrir la clé demandée
	2 En cas d'impossibilité d'ouvrir la clé principale demandée
	3 En cas d'impossibilité de se connecter à distance au registre
	-1 En cas d'impossibilité d'ouvrir valeur demandée
	-2 Si le type de valeur non pris en charge
@@End@@


###Remarks###
Une clé de registre doit commencer par "HKEY_LOCAL_MACHINE" ("HKLM") ou "HKEY_USERS" ("HKU") ou "HKEY_CURRENT_USER" ("HKCU") ou "HKEY_CLASSES_ROOT" ("HKCR") ou "HKEY_CURRENT_CONFIG" ("HKCC") .

Lors de l'exécution sur Windows 64 bits si vous voulez écrire une clé ou une valeur spécifique à l'environnement 64 bits, vous devez placer le suffixe HK ... avec 64 i.e. HKLM64.

AutoIt supporte les clés de registre de type REG_BINARY, REG_SZ, REG_MULTI_SZ, REG_EXPAND_SZ, REG_QWORD, et REG_DWORD.

Pour accéder à la valeur utilisée <b>(par défaut)</b> utilisez <b>""</b> (une chaîne vide) pour le nom de la valeur.

Lors de l'écriture d'une clé REG_MULTI_SZ vous devez séparer chaque valeur par @ LF. La valeur ne doit pas se terminer par @ LF sauf si vous voulez une chaîne vide (voir exemple).

Il est possible d'accéder à les registres à distance en utilisant des noms d'une valeur sous la forme "\\nom_ordinateur\nom_de_la_clé". Pour utiliser cette fonctionnalité vous devez avoir les droits d'accès correct sur NT/2000/XP/2003.


###Related###
RegDelete, RegRead, RegEnumKey, RegEnumVal


###Example###
@@IncludeExample@@

Traducteur : TT22

Contributeurs (pour les modifications avant le Wiki) :