Functions > Registry >

RegDelete

Supprime une cl� ou une valeur dans la base de registre.

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

Param�tres

keyname La cl� de la base de registre � supprimer.
valuename [optionnel] La valeur � supprimer.

Valeur de retour

Succ�s: Retourne 1.
Sp�cial: Retourne 0 si la cl�/valeur n'existe pas.
�chec: Retourne 2 si erreur lors de la suppression et d�finit @error <> 0.
@error: 1 = impossible d'ouvrir la cl� demand�e
2 = impossible d'ouvrir la cl� principale
3 = impossible de se connecter au registre distant
-1 = impossible de supprimer la valeur demand�e
-2 = impossible de supprimer la cl�/valeur demand�e

Remarques

Une cl� de base 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 une valeur sp�cifique � l'environnement 64-bits, il est n�cessaire de faire suivre HK... par 64. Par exemple : HKLM64.

Pour acc�der � la valeur Default, utilisez "" (une chaine vide) pour 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 "\\computername\keyname". Pour utiliser cette fonctionnalit�, vous devrez avoir les bons droits d'acc�s.

En relation

RegEnumKey, RegEnumVal, RegRead, RegWrite

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Regarde si la cl� de registre existe d�j�, pour ne pas endommager le syst�me de l'utilisateur.
    RegRead("HKEY_CURRENT_USER\Software\AutoIt_Example", "Key1")

    ; @error est d�fini <> 0 lors de la lecture d'une cl� de registre qui n'existe pas.
    If Not @error Then
        MsgBox($MB_SYSTEMMODAL, "", "Une erreur s'est produite, la cl� de registre temporaire  'AutoIt_Example' semble exister d�j�.")
        Return False
    EndIf

    ; Write a single REG_SZ value to the key "Key1".
    RegWrite("HKEY_CURRENT_USER\Software\AutoIt_Example", "Key1", "REG_SZ", "Ceci est un exemple de RegWrite")

    ; Ecrit la valeur REG_MULTI_SZ sur "Line 1" et "Line 2". Ajoute toujours un caract�re de saut de ligne suppl�mentaire lors de l'�criture d'une valeur REG_MULTI_SZ.
    RegWrite("HKEY_CURRENT_USER\Software\AutoIt_Example", "Key2", "REG_MULTI_SZ", "Line 1" & @LF & "Line 2" & @LF)

    ; Ecrit la valeur REG_MULTI_SZ sur "Line 1". Ajoute toujours un caract�re de saut de ligne suppl�mentaire lors de l'�criture d'une valeur REG_MULTI_SZ.
    RegWrite("HKEY_CURRENT_USER\Software\AutoIt_Example", "Key3", "REG_MULTI_SZ", "Line 1" & @LF)

    ; Ajoute un message pour naviguer dans RegEdit.exe manuellement.
    MsgBox($MB_SYSTEMMODAL, "", "Ouvre RegEdit.exe et navigue vers la cl� de registre "HKEY_CURRENT_USER\Software\AutoIt_Example"".")

    ; Supprime la cl� de registre temporaire.
    RegDelete("HKEY_CURRENT_USER\Software\AutoIt_Example")
EndFunc   ;==>Example