RegSetValueW

指定したレジストリキーの既定値または無名値にデータを設定する。データはテキスト文字列でなければならない。(Unicode)

RegSetValueW hKey, lpSubKey, dwType, lpData, cbData

hKey : [intptr] 開かれているレジストリキーへのハンドル。キーは KEY_SET_VALUE アクセス権で開かれている必要がある。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。
lpSubKey : [wstr] hKey パラメータのサブキーの名前。関数は指定したサブキーの既定値を設定する。lpSubKey が存在しない場合、関数はそれを作成する。キー名は大文字小文字を区別しない。このパラメータが NULL または空文字列を指す場合、関数は hKey で識別されるキーの既定値を設定する。詳細はレジストリ要素サイズ制限を参照のこと。
dwType : [int] 格納する情報の型。このパラメータは REG_SZ 型でなければならない。その他のデータ型を格納するには RegSetValueEx 関数を使用する。
lpData : [wstr] 格納するデータ。このパラメータは NULL にできない。
cbData : [int] このパラメータは無視される。関数は lpData パラメータのデータのサイズに基づいてこの値を計算する。

(プラグイン / モジュール : advapi32.dll)

解説

指定したレジストリキーの既定値または無名値にデータを設定する。データはテキスト文字列でなければならない。(Unicode)

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値は Winerror.h で定義された 0
以外のエラーコードとなる。FormatMessage 関数に FORMAT_MESSAGE_FROM_SYSTEM
フラグを指定して呼び出すと、エラーの一般的な説明を取得できる。

[備考]
lpSubKey パラメータで指定したキーが存在しない場合、RegSetValue 関数はそれを作成する。この関数の ANSI
版が（明示的に RegSetValueA を呼び出すか、Windows.h のインクルード前に UNICODE
を定義しないことで）使用されている場合、lpData パラメータは ANSI 文字列でなければならない。文字列はレジストリに格納される前に
Unicode に変換される。
> [!NOTE] > winreg.h ヘッダは RegSetValue をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報