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.
| Valor | Significado |
|---|---|
|
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 |