UDF > WinAPIEx > Registry >


_WinAPI_RegSetValue

D�finit la donn�e et le type de la valeur sp�cifi�e sous une cl� de registre

#include <WinAPIReg.au3>
_WinAPI_RegSetValue ( $hKey, $sValueName, $iType, $tValueData, $iBytes )

Param�tres

$hKey Handle de la cl� de registre ouverte. La cl� doit avoir �t� ouverte avec le droit d'acc�s $KEY_SET_VALUE.
Ce handle est retourn� par la fonction _WinAPI_RegCreateKey() ou _WinAPI_RegOpenKey(). Il peut �galement �tre l'une des cl�s pr�d�finies suivantes:
$HKEY_CLASSES_ROOT
$HKEY_CURRENT_CONFIG
$HKEY_CURRENT_USER
$HKEY_LOCAL_MACHINE
$HKEY_PERFORMANCE_DATA
$HKEY_USERS
$sValueName Le nom de la valeur � d�finir. Si une valeur avec ce nom n'est pas d�j� pr�sente dans la cl�, la fonction l'ajoute � la cl�. Si $sValueName est la cha�ne vide, la fonction d�finit le type et la donn�e pour la valeur sans nom ou par d�faut de la cl�.
$iType Le type de la donn�e. Ce param�tre peut prendre l'une des valeurs suivantes:
$REG_BINARY
$REG_DWORD
$REG_DWORD_BIG_ENDIAN
$REG_DWORD_LITTLE_ENDIAN
$REG_EXPAND_SZ
$REG_LINK
$REG_MULTI_SZ
$REG_NONE
$Reg_QWORD
$REG_QWORD_LITTLE_ENDIAN
$REG_SZ
$tValueData La structure (buffer) qui contient la donn�e � stocker. Pour les types cha�ne de caract�res, tels que REG_SZ, la cha�ne doit �tre termin�e par null. Avec le type de donn�es REG_MULTI_SZ, la cha�ne doit se terminer avec deux caract�res null. Une barre oblique inverse doit �tre pr�c�d�e par une autre barre oblique inverse comme caract�re d'�chappement.
Par exemple, indiquer "C:\\mydir\\myfile" pour stocker la cha�ne "C:\mydir\myfile".
$iBytes La taille de la donn�e, en octets. Si la donn�e a le type REG_SZ, REG_MULTI_SZ ou REG_EXPAND_SZ cette taille comprend les caract�res de terminaisons null sauf si la donn�e a �t� stock�e sans eux.

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 et d�finit @error <> 0, @extended peut contenir le code d'erreur du syst�me.

En relation

_WinAPI_RegCreateKey, _WinAPI_RegOpenKey

Voir aussi

Consultez RegSetValueEx dans la librairie MSDN.