共用方式為


CAtlTransactionManager::RegCreateKeyEx

建立指定之登錄機碼並將它與交易。 如果機碼已經存在,函式將它開啟。

inline LSTATUS CAtlTransactionManager::RegCreateKeyEx(
   HKEY hKey,
   LPCTSTR lpSubKey,
   DWORD dwReserved,
   LPTSTR lpClass,
   DWORD dwOptions,
   REGSAM samDesired,
   CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes,
   PHKEY phkResult,
   LPDWORD lpdwDisposition
);

參數

  • hKey
    至開啟登錄機碼的控制代碼。

  • lpSubKey
    這個函式會開啟或建立子機碼的名稱。

  • dwReserved
    這個參數是保留的,並且必須是零。

  • lpClass
    這個機碼使用者定義的類別。 這個參數可能會被忽略。 這個參數可以是 NULL。

  • dwOptions
    這個參數可以是下列其中一個值:REG_OPTION_BACKUP_RESTORE、REG_OPTION_NON_VOLATILE 或 REG_OPTION_VOLATILE。

  • samDesired
    指定金鑰存取權的遮罩。

  • lpSecurityAttributes
    要判斷的 SECURITY_ATTRIBUTES 結構的指標傳回的子處理序是否可以繼承基礎控制代碼。 如果 lpSecurityAttributes 是 NULL,控制代碼無法被繼承。

  • phkResult
    out 接收控制代碼開啟或建立索引鍵之變數的指標。 如果索引鍵不是預先定義的登錄機碼中,呼叫 RegCloseKey 函式使用控制代碼之後,在 中,在完成。

  • lpdwDisposition
    out 接收下一個字元之變數的指標值:REG_CREATED_NEW_KEY 或 REG_OPENED_EXISTING_KEY。

傳回值

如果函式成功,則傳回值為 ERROR_SUCCESS。 如果函式失敗,則傳回值是在 Winerror.h 定義的非零的錯誤碼。

備註

這個包裝函式呼叫 RegCreateKeyTransacted 函式。

需求

Header: atltransactionmanager.h

請參閱

參考

CAtlTransactionManager Class