RegOpenKeyTransactedA 函式 (winreg.h)
開啟指定的登錄機碼,並將它與交易產生關聯。 請注意,索引鍵名稱不區分大小寫。
語法
LSTATUS RegOpenKeyTransactedA(
[in] HKEY hKey,
[in, optional] LPCSTR lpSubKey,
[in] DWORD ulOptions,
[in] REGSAM samDesired,
[out] PHKEY phkResult,
[in] HANDLE hTransaction,
PVOID pExtendedParemeter
);
參數
[in] hKey
開啟登錄機碼的句柄。 RegCreateKeyEx、RegCreateKeyTransacted、RegOpenKeyEx 或 RegOpenKeyTransacted 函式會傳回此句柄。 它也可以是下列其中一個 預先定義的索引鍵:
HKEY_CLASSES_ROOTHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERS
[in, optional] lpSubKey
要開啟的登錄子機碼名稱。
索引鍵名稱不區分大小寫。
如果 lpSubKey 參數為 NULL 或空字串的指標,而且 hKey 是預先定義的索引鍵,則系統會重新整理預先定義的密鑰, 而 phkResult 會收到傳遞至函式的相同 hKey 句柄。 否則, phkResult 會收到已開啟密鑰的新句柄。
如需詳細資訊,請參閱 登錄專案大小限制。
[in] ulOptions
此參數是保留的,而且必須是零。
[in] samDesired
指定金鑰所需存取權限的遮罩。 如果密鑰的安全性描述項不允許呼叫進程的要求存取權,則函式會失敗。 如需詳細資訊,請參閱 登錄機碼安全性和訪問許可權。
[out] phkResult
接收已開啟索引鍵句柄之變數的指標。 如果機碼不是其中一個預先定義的登錄機碼,請在您使用句柄完成之後呼叫 RegCloseKey 函 式。
[in] hTransaction
使用中交易的句柄。 CreateTransaction 函式會傳回此句柄。
pExtendedParemeter
此參數是保留的,而且必須是 NULL。
傳回值
如果函式成功,傳回值會ERROR_SUCCESS。
如果函式失敗,傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標,以取得錯誤的一般描述。
備註
使用此函式開啟金鑰時,會交易金鑰上的後續作業。 如果在認可交易之前,在密鑰上執行非交易作業,則會回復交易。 認可或回復交易之後,您必須使用 RegCreateKeyTransacted 或 RegOpenKeyTransacted 函式來重新開啟密鑰,並搭配使用中的交易句柄,讓其他作業交易交易。 如需交易的詳細資訊,請參閱 核心交易管理員。
請注意,此金鑰子機碼的後續作業不會自動交易。 因此, RegDeleteKeyEx 函 式不會執行交易刪除作業。 請改用 RegDeleteKeyTransacted 函式來執行交易刪除作業。
不同於 RegCreateKeyTransacted 函式,如果登錄中沒有密鑰, RegOpenKeyTransacted 函式就不會建立指定的機碼。
如果您的服務或應用程式模擬不同的使用者,請勿將此函式與 HKEY_CURRENT_USER搭配使用。 請改為呼叫 RegOpenCurrentUser 函 式。
如果 phkResult 中傳回的機碼是預先定義的登錄機碼,則不會包含在提供的交易中。
單一登錄機碼只能開啟 65,534 次。 嘗試第 65,535次 開啟作業時,此函式會失敗並ERROR_NO_SYSTEM_RESOURCES。
注意
winreg.h 標頭會將 RegOpenKeyTransacted 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winreg.h (包含 Windows.h) |
程式庫 | Advapi32.lib |
Dll | Advapi32.dll |