CAtlTransactionManager::RegCreateKeyEx

Crea la clave del Registro especificada y la asocia a una transacción.Si la clave ya existe, la función abre.

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

Parámetros

• hKey
  Identificador de una clave del Registro abierto.

• lpSubKey
  El nombre de una subclave que esta función abrir o crear.

• dwReserved
  este parámetro se reserva y debe ser cero.

• lpClass
  La clase definida por el usuario de esta clave.Este parámetro se puede omitir.Este parámetro puede ser NULL.

• dwOptions
  Este parámetro puede tener uno de los siguientes valores: REG_OPTION_BACKUP_RESTORE, REG_OPTION_NON_VOLATILE, o REG_OPTION_VOLATILE.

• samDesired
  Una máscara que especifica los derechos de acceso para la clave.

• lpSecurityAttributes
  Puntero a una estructura de SECURITY_ATTRIBUTES que determina si el identificador devuelto se puede heredar de procesos secundarios.Si lpSecurityAttributes es NULL, el identificador no puede heredarse.

• phkResult
  Un puntero a una variable que recibe un identificador a la clave abierta o creada.Si la clave no es una de las claves del Registro predefinidas, llame a la función de RegCloseKey después de haber terminado de utilizar el identificador.

• lpdwDisposition
  Un puntero a una variable que recibe uno de disponibilidad siguiente valora: REG_CREATED_NEW_KEY o REG_OPENED_EXISTING_KEY.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es ERROR_SUCCESS.Si se produce un error en la función, el valor devuelto es un código de error distinto definido en Winerror.h.

Comentarios

Este contenedor llama a la función de RegCreateKeyTransacted .

Requisitos

encabezado: atltransactionmanager.h

Vea también

Referencia

Clase de CAtlTransactionManager