Win32API: RegSetValueEx

指定したレジストリキーの値を設定します。

定義 
Declare Function RegSetValueEx Lib "advapi32" Alias "RegSetValueExA" _
   (hKey As HKEY, _
    lpValueName As String, _
    Reserved As DWord, _
    dwType As DWord, _
    lpData As VoidPtr, _
    cbData As DWord) As Long
hKey
既存のキーのハンドルを指定します。以下の定義済みハンドルから指定することもできます。
ハンドル説明
HKEY_CLASSES_ROOT拡張子に関する情報、Windowsにインストールされているコンポーネントに関する情報などが格納されています。
HKEY_CURRENT_USER現在のユーザーが使用するためのOS、アプリケーションに関する情報などが格納されています。
HKEY_LOCAL_MACHINEコンピュータ固有の情報などが格納されています。
HKEY_USERSすべてのユーザーに関する情報などが格納されています。

lpValueName
設定する値の名前を指定します。

Reserved
予約されています。0 を指定して下さい。

dwType
データの種類を、以下の定数から指定します。
定数説明
REG_BINARY任意の形式のバイナリデータです。
REG_DWORD
、または REG_DWORD_LITTLE_ENDIAN		32 ビット値です。
REG_DWORD_BIG_ENDIANビッグエンディアン形式の 32 ビット値です。
REG_EXPAND_SZ展開前の環境変数への参照 (たとえば "%PATH%" ) が入った NULL で終わる文字列です。
REG_LINKUnicode のシンボリックリンクです。
REG_MULTI_SZNULL で終わる文字列の配列です。連続する 2 つの NULL 文字で、終端を示します。
REG_NONE定義されていない種類です。
REG_RESOURCE_LISTデバイスドライバのリソースリストです。
REG_SZNULL で終わる文字列です。

lpData
設定するデータが格納されているバッファへのポインタを指定します。

cbData
lpData パラメータで指定したデータのバイト数を指定します。データが文字列のときは、終端の NULL 文字も含めなければなりません。

戻り値

関数が成功すると、ERROR_SUCCESS が返ります。失敗すると、0 以外の値のエラーコードが返ります。

解説

hKey パラメータで指定するキーは、KEY_SET_VALUE 権を持っていなければなりません。
指定したキーの値が存在しないときは、新たに追加されます。

環境情報

インクルード ファイル: api_reg.sbp 内で定義済み
DLLファイル: advapi32.dll

RegCreateKeyEx関数、RegOpenKeyEx関数、RegQueryValueEx関数