Función CreateTransactionManager (ktmw32.h)

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.

[in, optional] CommitStrength

Reservado; 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, se INVALID_HANDLE_VALUE el valor devuelto. Para obtener información de error extendida, llame a la función GetLastError.

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

Observaciones

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

Consulte también

funciones del Administrador de transacciones de kernel

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES