RegSetKeyValueW

指定したレジストリキーおよびサブキー内の指定した値にデータを設定する。(Unicode)

RegSetKeyValueW hKey, lpSubKey, lpValueName, dwType, lpData, cbData

hKey : [intptr] 開かれているレジストリキーへのハンドル。キーは KEY_SET_VALUE アクセス権で開かれている必要がある。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。
lpSubKey : [wstr] hKey で識別されるキーに対する相対的なサブキーの名前。サブキーが存在しない場合、既定のセキュリティ記述子を持つ不揮発性キーとして作成される。このパラメータが NULL の場合、hKey で指定されたキーに値が作成される。
lpValueName : [wstr] データを更新するレジストリ値の名前。
dwType : [int] lpData パラメータが指すデータの型。型の一覧についてはレジストリ値の型を参照のこと。
lpData : [intptr] 指定した値名と一緒に格納するデータ。REG_SZ などの文字列ベースの型では、文字列は null で終端されている必要がある。REG_MULTI_SZ データ型では、文字列は 2 つの null 文字で終端されている必要がある。
cbData : [int] lpData パラメータが指す情報のサイズ（バイト単位）。データの型が REG_SZ、REG_EXPAND_SZ、または REG_MULTI_SZ の場合、cbData には終端 null 文字のサイズを含めなければならない。

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

解説

指定したレジストリキーおよびサブキー内の指定した値にデータを設定する。(Unicode)

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

[備考]
この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0600 以降に定義する。詳細は Windows
ヘッダの使用を参照のこと。
> [!NOTE] > winreg.h ヘッダは RegSetKeyValue をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報