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
    用于接收句柄中打开的或创建的密钥的变量的指针。 如果该项不是一个预定义的注册表项,请调用 RegCloseKey 函数使用处理之后,在完成。

  • lpdwDisposition
    用于接收下列示例结果的变量的指针值:REG_CREATED_NEW_KEY或REG_OPENED_EXISTING_KEY。

返回值

如果函数成功,则返回值是ERROR_SUCCESS。 如果函数失败,则返回值是在Winerror.h定义的一个非零错误代码。

备注

此包装调用 RegCreateKeyTransacted 功能。

要求

Header: atltransactionmanager.h

请参见

参考

CAtlTransactionManager选件类