Leer en inglés

Compartir a través de


Alistamientos

Un administrador de recursos se inscribe en una transacción cuando comienza la participación en esa transacción concreta. La inscripción define qué notificaciones acepta el administrador de recursos. Un administrador de recursos crea un objeto de inscripción cuando se inscribe en una transacción. Este objeto señala a KTM que el administrador de recursos (RM) solicita notificaciones sobre la transacción especificada.

Rm proporciona una estructura de NOTIFICATION_MASK que detalla qué notificaciones solicita.

Funciones de inscripción

Las siguientes funciones se usan con las inscripciones.

Función Descripción
CommitComplete Indica que un administrador de recursos (RM) ha terminado de confirmar una transacción solicitada por el administrador de transacciones (TM).
CreateEnlistment Crea una inscripción, establece su estado inicial y abre un identificador para la inscripción con el acceso especificado.
GetEnlistmentRecoveryInformation Recupera una estructura opaca de datos de recuperación de KTM. La información de recuperación se almacena en un registro en nombre de un administrador de recursos (RM) mediante una llamada a la función SetEnlistmentRecoveryInformation . Después de un error, RM puede usar la función GetEnlistmentRecoveryInformation para recuperar la información.
OpenEnlistment Abre un objeto de inscripción existente y devuelve un identificador a la inscripción.
ReadOnlyEnlistment Solicita que la inscripción especificada se convierta en una inscripción de solo lectura. Una inscripción de solo lectura no puede participar en el resultado de la transacción y no se registra de forma duradera para la recuperación.
RollbackEnlistment Revierte la transacción especificada asociada a una inscripción. No se puede llamar a esta función para las inscripciones de solo lectura.
SetEnlistmentRecoveryInformation Establece una estructura opaca definida por el usuario de datos de recuperación de KTM. La información de recuperación se almacena en un registro en nombre de un administrador de recursos (RM) mediante una llamada a SetEnlistmentRecoveryInformation. Después de un error, RM puede usar GetEnlistmentRecoveryInformation para recuperar la información.
SinglePhaseReject Indica que el administrador de recursos (RM) rechaza una solicitud de una sola fase. Cuando un administrador de transacciones (TM) recibe esta llamada, inicia una confirmación en dos fases y envía una solicitud de preparación a todos los RMs inscritos.