RegOverridePredefKey

定義済みレジストリキーを指定したレジストリキーにマップする。

RegOverridePredefKey hKey, hNewHKey

hKey : [intptr] 以下の定義済みキーのいずれかへのハンドル: - HKEY_CLASSES_ROOT - HKEY_CURRENT_CONFIG - HKEY_CURRENT_USER - HKEY_LOCAL_MACHINE - HKEY_PERFORMANCE_DATA - HKEY_USERS
hNewHKey : [intptr] 開かれているレジストリキーへのハンドル。このハンドルは RegCreateKeyEx または RegOpenKeyEx 関数が返す。定義済みキーを指定することはできない。関数は hKey を hNewHKey キーを参照するようにマップする。これは呼び出し側プロセスのみに影響する。hNewHKey が NULL の場合、関数は定義済みキーの既定のマッピングを復元する。

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

解説

定義済みレジストリキーを指定したレジストリキーにマップする。

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

[備考]
RegOverridePredefKey
関数はソフトウェアインストールプログラム向けのものである。これにより、定義済みキーを再マップし、システムにインストールされる DLL
コンポーネントをロードし、DLL
内のエントリポイントを呼び出し、コンポーネントがレジストリに対して試みた変更を調べることができる。インストールプログラムはその後、それらの変更を
DLL が意図した場所に書き込むか、書き込む前にデータに変更を加えることができる。たとえば、アプリケーションインストールの一部として
ActiveX
コントロールをインストールするインストールプログラムを考える。インストールプログラムは、コントロールが自身を登録できるようにするため、コントロールの
DllRegisterServer エントリポイントを呼び出す必要がある。この呼び出しの前に、インストールプログラムは
RegOverridePredefKey を呼び出して HKEY_CLASSES_ROOT を
HKEY_CURRENT_USER\TemporaryInstall\DllRegistration などの一時キーに再マップできる。次に
DllRegisterServer を呼び出すと、ActiveX
コントロールは自身のレジストリエントリを一時キーに書き込む。その後、インストールプログラムは再度 RegOverridePredefKey
を呼び出して HKEY_CLASSES_ROOT
の元のマッピングを復元する。インストールプログラムは、必要に応じて一時キーに書き込まれたキーを変更した上で、元の
HKEY_CLASSES_ROOT にコピーできる。RegOverridePredefKey の呼び出し後、RegCloseKey
を呼び出して hNewHKey ハンドルを安全に閉じることができる。システムは hNewHKey への独自の参照を保持する。

情報