RegOpenKeyA 函式 （winreg.h）
開啟指定的登錄機碼。
語法
LSTATUS RegOpenKeyA(
[in] HKEY hKey,
[in, optional] LPCSTR 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 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winreg.h （包括 Windows.h） |
| 連結庫 | Advapi32.lib |
| DLL | Advapi32.dll |