RegLoadAppKeyW

指定したレジストリハイブをアプリケーションハイブとしてロードする。(Unicode)

RegLoadAppKeyW lpFile, phkResult, samDesired, dwOptions, Reserved

lpFile : [wstr] ハイブファイルの名前。このハイブは RegSaveKey または RegSaveKeyEx 関数で作成されている必要がある。ファイルが存在しない場合、指定した名前で空のハイブファイルが作成される。
phkResult : [intptr] ロードされたハイブのルートキーのハンドルへのポインタ。ハイブ内のキーにアクセスする唯一の方法はこのハンドル経由である。レジストリは、キーへの絶対パスを使用してこのハイブ内のキーにアクセスすることを防ぐ。結果として、レジストリの名前空間を通じてこのハイブに移動することはできない。
samDesired : [int] 返されるルートキーに対して要求するアクセス権を指定するマスク。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。
dwOptions : [int] このパラメータが REG_PROCESS_APPKEY の場合、呼び出し側によってロードされている間、ハイブを再度ロードすることはできない。これにより、別の呼び出し側がこのレジストリハイブにアクセスすることを防ぐ。
Reserved : [int] このパラメータは予約されている。

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

解説

指定したレジストリハイブをアプリケーションハイブとしてロードする。(Unicode)

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

[備考]
RegLoadKey とは異なり、RegLoadAppKey はハイブを HKEY_LOCAL_MACHINE や HKEY_USERS
の下にロードしない。代わりに、ハイブは列挙できない特別なルートの下にロードされる。その結果、RegLoadAppKey
で現在ロードされているハイブを列挙する方法はない。RegLoadAppKey
でロードされたハイブに対するすべての操作は、phkResult で返されたハンドルに対する相対で実行する必要がある。
2 つのプロセスが同じハイブに対して操作を実行する必要がある場合、各プロセスはハンドルを取得するために RegLoadAppKey
を呼び出さなければならない。RegLoadAppKey
操作中、レジストリはファイルがすでにロードされているかを検証する。ロードされていた場合、ハイブを再ロードするのではなく、以前にロードされたハイブへのハンドルを返す。

ハイブ内のすべてのキーは同じセキュリティ記述子を持っていなければならず、そうでなければ関数は失敗する。このセキュリティ記述子は、samDesired
パラメータで指定されたアクセスを呼び出し側に付与する必要があり、そうでなければ関数は失敗する。ハイブ内のキーに対して
RegSetKeySecurity 関数を使用することはできない。Windows 8 以降では、各プロセスは RegLoadAppKey
を呼び出して複数のハイブをロードできる。Windows 7 以前では、各プロセスは同時に 1 つのハイブしか RegLoadAppKey
でロードできない。RegLoadAppKey でロードされたハイブは、ハイブ内のキーへのすべてのハンドルが RegCloseKey
で閉じられると自動的にアンロードされる。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0600
以降に定義する。詳細は Windows ヘッダの使用を参照のこと。
> [!NOTE] > winreg.h ヘッダは RegLoadAppKey をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報