RegOpenCurrentUser 函式 (winreg.h)

  • 發行項

擷取目前線程正在模擬之使用者的 HKEY_CURRENT_USER 索引鍵控制碼。

語法

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

參數

[in] samDesired

指定金鑰所需存取權限的遮罩。 如果金鑰的安全性描述項不允許呼叫進程的要求存取權，則函式會失敗。 如需詳細資訊，請參閱 登錄機碼安全性和存取權限。

[out] phkResult

接收已開啟索引鍵控制碼之變數的指標。 當您不再需要傳回的控制碼時，請呼叫 RegCloseKey 函 式來關閉它。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤的一般描述。

備註

HKEY_CURRENT_USER機碼會對應至HKEY_USERS金鑰中目前使用者分支的根目錄。 系統會針對進程中的所有線程快取它。 因此，載入另一個使用者的設定檔時，此值不會變更。 RegOpenCurrentUser 會使用執行緒的權杖來存取適當的金鑰，如果未載入設定檔，則為預設值。

規格需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winreg.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

RegCloseKey

登錄函式

登錄概觀