Functions > Registry >


RegRead

Lit une valeur dans la base de registre.

RegRead ( "keyname", "valuename" )

Param�tres

keyname La cl� de la base de registre � lire.
valuename La valeur � lire.

Valeur de retour

Succ�s: Retourne la valeur de la base de registre demand�e. @extended contient le type de la valeur $REG_... . Ces types sont d�finis dans "Constants.au3".
�chec: D�finit @error <> 0.
@error: 1 = impossible d'ouvrir la cl� demand�e
2 = impossible d'ouvrir la cl� principale demand�e
3 = impossible de se connecter � distance au Registre
-1 = impossible d'ouvrir la valeur demand�e
-2 = type de valeur non pris en charge

Remarques

Une cl� de la 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").

Lors de l'ex�cution sur Windows 64 bits si vous souhaitez lire une valeur sp�cifique � l'environnement 64 bits, vous devez suffixer HK... avec 64 c'est � dire 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 par (Default) utilisez "" (une cha�ne vide) pour le nom de la valeur.

Lors de la lecture d'une cl� REG_BINARY le r�sultat est un type de donn�es binaire (dans les versions pr�c�dentes, il �tait une cha�ne de caract�res hexad�cimaux).

Lors de la lecture d'une cl� de REG_MULTI_SZ les multiples entr�es sont s�par�es par @LF - � utiliser avec StringSplit (..., @LF) pour obtenir chaque entr�e.

Il est possible d'acc�der � des bases de registre distantes en utilisant un nom de cl� de la forme "\\ordinateur\nom de cl� ". Pour utiliser cette fonction, vous devez avoir les droits d'acc�s appropri�s.

En relation

RegDelete, RegWrite, StringSplit

Exemple

#include <MsgBoxConstants.au3>

Local $sFilePath = RegRead("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion", "ProgramFilesDir")
MsgBox($MB_SYSTEMMODAL, "", "Les fichiers programmes sont dans:", $sFilePath)