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 |