RegOpenKeyW 函式 (winreg.h)
開啟指定的登錄機碼。
語法
LSTATUS RegOpenKeyW(
[in] HKEY hKey,
[in, optional] LPCWSTR lpSubKey,
[out] PHKEY phkResult
);
參數
[in] hKey
開啟登錄機碼的控制碼。 RegCreateKeyEx或RegOpenKeyEx函式會傳回此控制碼，或者它可以是下列其中一個預先定義的索引鍵：
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_USERS
[in, optional] lpSubKey
要開啟的登錄機碼名稱。 此金鑰必須是 hKey 參數所識別金鑰的子 機碼 。
索引鍵名稱不區分大小寫。
如果此參數為 Null 或空字串的指標，函式會傳回傳入的相同控制碼。
如需詳細資訊，請參閱 登錄專案大小限制。
[out] phkResult
接收已開啟索引鍵控制碼之變數的指標。 如果機碼不是其中一個預先定義的登錄機碼，請在您使用控制碼完成之後呼叫 RegCloseKey 函 式。
傳回值
如果函式成功，傳回值會ERROR_SUCCESS。
如果函式失敗，傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤的一般描述。
備註
RegOpenKey 函式會使用預設的安全性存取遮罩來開啟金鑰。 如果開啟金鑰需要不同的存取權限，函式會失敗，並傳回ERROR_ACCESS_DENIED。 應用程式應該使用 RegOpenKeyEx 函式來指定在此情況下的存取遮罩。
如果索引鍵不存在於資料庫中，則 RegOpenKey不會建立指定的索引鍵。
如果您的服務或應用程式模擬不同的使用者，請勿將此函式與 HKEY_CURRENT_USER搭配使用。 請改為呼叫 RegOpenCurrentUser 函 式。
注意
winreg.h 標頭會將 RegOpenKey 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | winreg.h (包含 Windows.h) |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |