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.