RegOpenKeyW

指定したレジストリキーを開く。(Unicode)

RegOpenKeyW hKey, lpSubKey, phkResult

hKey : [intptr] 開かれているレジストリキーへのハンドル。このハンドルは RegCreateKeyEx または RegOpenKeyEx 関数が返すか、以下の定義済みキーのいずれかを指定できる: * HKEY_CLASSES_ROOT * HKEY_CURRENT_CONFIG * HKEY_CURRENT_USER * HKEY_LOCAL_MACHINE * HKEY_USERS
lpSubKey : [wstr] 開くレジストリキーの名前。このキーは hKey パラメータで識別されるキーのサブキーでなければならない。キー名は大文字小文字を区別しない。このパラメータが NULL または空文字列へのポインタである場合、関数は渡されたものと同じハンドルを返す。詳細はレジストリ要素サイズ制限を参照のこと。
phkResult : [intptr] 開かれたキーへのハンドルを受け取る変数へのポインタ。キーが定義済みレジストリキーでない場合、ハンドルの使用が終わったら RegCloseKey 関数を呼び出す。

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

解説

指定したレジストリキーを開く。(Unicode)

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

[備考]
RegOpenKey
関数は既定のセキュリティアクセスマスクを使用してキーを開く。キーを開くのに異なるアクセス権が必要な場合、関数は失敗して
ERROR_ACCESS_DENIED を返す。この状況ではアプリケーションは RegOpenKeyEx
関数を使用してアクセスマスクを指定すべきである。RegOpenKey
は、キーがデータベースに存在しない場合に指定したキーを作成しない。サービスやアプリケーションが複数のユーザをインパーソネートする場合、この関数を
HKEY_CURRENT_USER に対して使用してはならない。代わりに RegOpenCurrentUser 関数を呼び出す。
> [!NOTE] > winreg.h ヘッダは RegOpenKey をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて ANSI または Unicode
版を自動的に選択する。エンコーディングに中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイル時または実行時エラーとなる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報