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 )
$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. |
Succès: | Retourne 1. |
Échec: | Retourne 0 et définit @error <> 0, @extended peut contenir le code d'erreur du système. |
_WinAPI_RegCreateKey, _WinAPI_RegOpenKey
Consultez RegSetValueEx dans la librairie MSDN.