Aide:RegDelete.txt

De Wiki AutoIt Français
Aller à : navigation, rechercher

Document original V3.3.6.1 :

###Function###
RegDelete

###Description###
Deletes a key or value from the registry.

###Syntax###
RegDelete ( "keyname" [, "valuename"] )


###Parameters###
@@ParamTable@@
keyname
	The registry key to delete.
valuename
	[optional] The valuename to delete.
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Special:	Returns 0 if the key/value does not exist.
Failure:	Returns 2 if error deleting key/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 delete requested value
	-2 if unable to delete requested key/value
@@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 delete a key or value specific to the 64-bit environment you have to suffix the HK... with 64 i.e. HKLM64.

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

Deleting from the registry is potentially dangerous--please exercise caution!

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.


###Related###
RegRead, RegWrite, RegEnumKey, RegEnumVal


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


Document traduit V3.3.6.1 :

###Function###
RegDelete

###Description###
Supprime une clé ou une valeur dans le registre.


###Syntax###
RegDelete ( "keyname" [, "valuename"] )


###Parameters###
@@ParamTable@@
keyname
	La clé de registre à supprimer.
valuename
	[optionnel] La valeur à supprimer.
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès :	Retourne 1.
Spécial:	Retourne 0 si la clé/valeur n'existe pas.
Échec  :	Retourne 2 en cas d'erreur lors de la suppression.
		@error peux prendre les valeurs suivantes :
		1 si impossibilité d'ouvrir la clé demandée
		2 si impossibilité d'ouvrir la clé principale
		3 si impossibilité de se connecter au registre distant
	       -1 si impossibilité de supprimer la valeur demandée
	       -2 si impossibilité de supprimer la clé/valeur demandée
@@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").

Dans un système Windows 64-bits, si vous souhaitez supprimer une clé ou valeur spécifique à l'environnement 64-bits, il est nécessaire de faire suivre HK... par 64. Par exemple : HKLM64.

Pour atteindre la valeur <b>(par défaut)<b>, utilisez <b>""</b> (une chaine vide) en paramètre valuename.

Supprimer une clé dans le registre est potentiellement dangereux -- A utiliser avec précaution!

Il est possible d'accéder à des registres distants en utilisant un nom de clé sous la forme "\\ordinateur\clé". Pour utiliser cette fonctionnalité, vous devrez avoir les bons droits d'accès.


###Related###
<a href="RegRead.htm">RegRead</a>, <a href="RegWrite.htm">RegWrite</a>, <a href="RegEnumKey.htm">RegEnumKey</a>, <a href="RegEnumVal.htm">RegEnumVal</a>


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



Traducteur : HeaTon