RegOpenKeyTransactedA 函式（winreg.h）

發行項
11/20/2024

開啟指定的登錄機碼，並將它與交易產生關聯。請注意，索引鍵名稱不區分大小寫。

語法

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 標頭會根據 UNICODE 預處理器常數的定義，將 RegOpenKeyTransacted 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winreg.h （包括 Windows.h）
連結庫	Advapi32.lib
DLL	Advapi32.dll