RegOpenCurrentUser 関数 (winreg.h)

  • [アーティクル]

現在のスレッドが偽装しているユーザーの HKEY_CURRENT_USER キーへのハンドルを取得します。

構文

LSTATUS RegOpenCurrentUser(
  [in]  REGSAM samDesired,
  [out] PHKEY  phkResult
);

パラメーター

[in] samDesired

キーに対して必要なアクセス権を指定するマスク。 キーのセキュリティ記述子が呼び出し元プロセスに対して要求されたアクセスを許可しない場合、関数は失敗します。 詳細については、「 レジストリ キーのセキュリティとアクセス権」を参照してください。

[out] phkResult

開かれたキーへのハンドルを受け取る変数へのポインター。 返されたハンドルが不要になったら、 RegCloseKey 関数を呼び出して閉じます。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は Winerror.h で定義されている 0 以外のエラー コードです。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用すると、エラーの一般的な説明を取得できます。

解説

HKEY_CURRENT_USER キーは、HKEY_USERS キー内の現在のユーザーのブランチのルートにマップされます。 プロセス内のすべてのスレッドに対してキャッシュされます。 したがって、この値は、別のユーザーのプロファイルが読み込まれるときに変更されません。 RegOpenCurrentUser は、スレッドのトークンを使用して適切なキーにアクセスします。プロファイルが読み込まれていない場合は既定値です。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winreg.h (Windows.h を含む)
Library Advapi32.lib
[DLL] Advapi32.dll

関連項目

RegCloseKey

レジストリ関数

レジストリの概要