RegOpenKeyA 函式 (winreg.h)

開啟指定的登錄機碼。

注意此函式僅適用於與16位版本的Windows相容。應用程式應該使用 RegOpenKeyEx 函式。

語法

LSTATUS RegOpenKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [out]          PHKEY  phkResult
);

[in] hKey

開啟登錄機碼的句柄。 RegCreateKeyEx 或 RegOpenKeyEx 函式會傳回此句柄，或者它可以是下列其中一個預先定義的索引鍵：

[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 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。