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