CAtlTransactionManager::RegCreateKeyEx

Creates the specified registry key and associates it with a transaction. If the key already exists, the function opens it.

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

Parameters

• hKey
  A handle to an open registry key.

• lpSubKey
  The name of a subkey that this function opens or creates.

• dwReserved
  This parameter is reserved and must be zero.

• lpClass
  The user-defined class of this key. This parameter may be ignored. This parameter can be NULL.

• dwOptions
  This parameter can be one of the following values: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE, or REG_OPTION_VOLATILE.

• samDesired
  A mask that specifies the access rights for the key.

• lpSecurityAttributes
  Pointer to a SECURITY_ATTRIBUTES structure that determines whether the returned handle can be inherited by child processes. If lpSecurityAttributes is NULL, the handle cannot be inherited.

• phkResult
  A pointer to a variable that receives a handle to the opened or created key. If the key is not one of the predefined registry keys, call the RegCloseKey function after you have finished using the handle.

• lpdwDisposition
  A pointer to a variable that receives one of the following disposition values: REG_CREATED_NEW_KEY or REG_OPENED_EXISTING_KEY.

Return Value

If the function succeeds, the return value is ERROR_SUCCESS. If the function fails, the return value is a nonzero error code defined in Winerror.h.

Remarks

This wrapper calls the RegCreateKeyTransacted function.

Requirements

Header: atltransactionmanager.h

See Also

Reference

CAtlTransactionManager Class