RegOpenCurrentUser

現在のスレッドがインパーソネートしているユーザの HKEY_CURRENT_USER キーへのハンドルを取得する。

RegOpenCurrentUser samDesired, phkResult

samDesired : [int] キーに対して要求するアクセス権を指定するマスク。キーのセキュリティ記述子が呼び出し側プロセスに対して要求されたアクセスを許可しない場合、関数は失敗する。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。
phkResult : [intptr] 開かれたキーへのハンドルを受け取る変数へのポインタ。返されたハンドルが不要になったら、RegCloseKey 関数を呼び出して閉じる。

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

解説

現在のスレッドがインパーソネートしているユーザの HKEY_CURRENT_USER キーへのハンドルを取得する。

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

[備考]
HKEY_CURRENT_USER キーは、HKEY_USERS
キー内の現在のユーザのブランチのルートにマップされる。これはプロセス内のすべてのスレッドに対してキャッシュされる。したがって、別のユーザのプロファイルがロードされてもこの値は変化しない。RegOpenCurrentUser
は、スレッドのトークンを使用して適切なキーにアクセスするか、プロファイルがロードされていない場合は既定にアクセスする。

情報