RegCreateKeyW

指定したレジストリキーを作成する。キーがレジストリにすでに存在する場合、関数はそれを開く。(Unicode)

RegCreateKeyW hKey, lpSubKey, phkResult

hKey : [intptr] 開かれているレジストリキーへのハンドル。呼び出し側プロセスはそのキーに対する KEY_CREATE_SUB_KEY アクセス権を持っている必要がある。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。
lpSubKey : [wstr] この関数が開くか作成するキーの名前。このキーは hKey パラメータで識別されるキーのサブキーでなければならない。
phkResult : [intptr] 開いたまたは作成したキーへのハンドルを受け取る変数へのポインタ。キーが定義済みレジストリキーでない場合、ハンドルの使用が終わったら RegCloseKey 関数を呼び出す。

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

解説

指定したレジストリキーを作成する。キーがレジストリにすでに存在する場合、関数はそれを開く。(Unicode)

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

[備考]
アプリケーションは HKEY_USERS や HKEY_LOCAL_MACHINE の直下のキーを作成できない。HKEY_USERS や
HKEY_LOCAL_MACHINE
ツリーのより下位のレベルではサブキーを作成できる。サービスやアプリケーションが複数のユーザをインパーソネートする場合、この関数を
HKEY_CURRENT_USER に対して使用してはならない。代わりに RegOpenCurrentUser
関数を呼び出す。RegCreateKey
関数は指定したパス内の不足するすべてのキーを作成する。この動作を利用して、複数のキーを一度に作成できる。たとえば、lpSubKey
パラメータに subkey1\subkey2\subkey3\subkey4 のような文字列を指定することで、4
レベル下のサブキーと同時に先行する 3
つのサブキーを作成できる。なお、パス内の既存キーのつづりが誤っている場合、この動作によって意図しないキーが作成される。
> [!NOTE] > winreg.h ヘッダは RegCreateKey をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報