Función CreateTransactionManager (ktmw32.h)

  • Artículo

Crea un nuevo objeto de administrador de transacciones (TM) y devuelve un identificador con el acceso especificado.

Sintaxis

HANDLE CreateTransactionManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpTransactionAttributes,
  [in, optional] LPWSTR                LogFileName,
  [in, optional] ULONG                 CreateOptions,
  [in, optional] ULONG                 CommitStrength
);

Parámetros

[in, optional] lpTransactionAttributes

La transacción SECURITY_ATTRIBUTES (ACL) para el objeto TM.

[in, optional] LogFileName

Nombre del flujo de archivo de registro. Si la secuencia no existe en el registro, se crea. Para crear un TM volátil, este parámetro debe ser NULL y CreateOptions debe especificar TRANSACTION_MANAGER_VOLATILE, este administrador de transacciones se considera volátil.

[in, optional] CreateOptions

Cualquier atributo opcional para el nuevo TM.

Valor Significado
TRANSACTION_MANAGER_VOLATILE
 Indica que el TM es volátil y no realiza la recuperación.

[in, optional] CommitStrength

Reservados; especifique cero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el administrador de transacciones.

Si se produce un error en la función, el valor devuelto es INVALID_HANDLE_VALUE. Para obtener información ampliada de los errores, llame a la función GetLastError.

En la lista siguiente se identifican los posibles códigos de error:

Comentarios

Inmediatamente después de llamar a esta función, debe llamar a RecoverTransactionManager.

Si el administrador de transacciones es volátil, todos los administradores de recursos también deben ser volátiles.

Debe llamar a RecoverTransactionManager después de crear un TM para que el TM funcione correctamente.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado ktmw32.h
Library Ktmw32.lib
Archivo DLL Ktmw32.dll

Consulte también

Funciones del Administrador de transacciones de kernel

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES