# Function Reference

# _WinAPI_RegSetValue

Sets the data and type of a specified value under a registry key

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

## Parameters

$hKey | Handle to an open registry key. The key must have been opened with the $KEY_SET_VALUE access right. This handle is returned by the _WinAPI_RegCreateKey() or _WinAPI_RegOpenKey() function. It can also be one of the following predefined keys: $HKEY_CLASSES_ROOT $HKEY_CURRENT_CONFIG $HKEY_CURRENT_USER $HKEY_LOCAL_MACHINE $HKEY_PERFORMANCE_DATA $HKEY_USERS
$sValueName | The name of the value to be set. If a value with this name is not already present in the key, the function adds it to the key. If $sValueName is empty string, the function sets the type and data for the key's unnamed or default value.
$iType | The type of data. This parameter can be one of the following values : $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 | The structure (buffer) that contains the data to be stored. For string-based types, such as REG_SZ, the string must be null-terminated. With the REG_MULTI_SZ data type, the string must be terminated with two null characters. A backslash must be preceded by another backslash as an escape character. For example, specify "C:\\mydir\\myfile" to store the string "C:\mydir\myfile".
$iBytes | The size of the data, in bytes. If the data has the REG_SZ, REG_MULTI_SZ or REG_EXPAND_SZ type, this size includes any terminating null character or characters unless the data was stored without them.

## Return Value

Success: | 1.
Failure: | 0 and sets the @error flag to non-zero, @extended flag may contain the system error code.

## Related

_WinAPI_RegCreateKey, _WinAPI_RegOpenKey

## See Also

Search RegSetValueEx in MSDN Library.