RegLoadKeyW

HKEY_USERS または HKEY_LOCAL_MACHINE の下にサブキーを作成し、指定したレジストリハイブからのデータをそのサブキーにロードする。(Unicode)

RegLoadKeyW hKey, lpSubKey, lpFile

hKey : [intptr] サブキーを作成する対象のキーへのハンドル。これは RegConnectRegistry の呼び出しで返されたハンドル、または以下の定義済みハンドルのいずれかである:
lpSubKey : [wstr] hKey の下に作成するキーの名前。このサブキーに、ファイルからのレジストリ情報がロードされる。
lpFile : [wstr] レジストリデータを含むファイルの名前。このファイルは RegSaveKey 関数で作成されたローカルファイルでなければならない。ファイルが存在しない場合、指定した名前でファイルが作成される。

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

解説

HKEY_USERS または HKEY_LOCAL_MACHINE
の下にサブキーを作成し、指定したレジストリハイブからのデータをそのサブキーにロードする。(Unicode)

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

[備考]
レジストリハイブファイルには 2
つの形式がある。現在のオペレーティングシステムで作成されたレジストリハイブは、通常、それ以前のバージョンではロードできない。hKey が
RegConnectRegistry で返されたハンドルである場合、lpFile
で指定されたパスはリモートコンピュータに対する相対となる。呼び出し側プロセスはレジストリが存在するコンピュータ上で
SE_RESTORE_NAME および SE_BACKUP_NAME
特権を持っている必要がある。詳細は特殊な特権での実行を参照のこと。これらの特殊な特権を必要とせずにハイブをロードするには、RegLoadAppKey
関数を使用する。
> [!NOTE] > winreg.h ヘッダは RegLoadKey をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報