Inscrições
Um gerenciador de recursos se inscreve em uma transação quando inicia a participação nessa transação específica. A inscrição define quais notificações o gerenciador de recursos aceita. Um gerenciador de recursos cria um objeto de inscrição quando ele se inscreve em uma transação. Esse objeto sinaliza para o KTM que o gerenciador de recursos (RM) está solicitando notificações sobre a transação especificada.
A RM fornece uma estrutura NOTIFICATION_MASK que detalha quais notificações ele está solicitando.
As funções a seguir são usadas com alistamentos.
Função | Descrição |
---|---|
CommitComplete | Indica que um gerenciador de recursos (RM) terminou de confirmar uma transação que foi solicitada pelo TM (gerenciador de transações). |
CreateEnlistment | Cria um alistamento, define seu estado inicial e abre um identificador para a inscrição com o acesso especificado. |
GetEnlistmentRecoveryInformation | Recupera uma estrutura opaca de dados de recuperação do KTM. As informações de recuperação são armazenadas em um log em nome de um gerenciador de recursos (RM) chamando a função SetEnlistmentRecoveryInformation . Após uma falha, a RM pode usar a função GetEnlistmentRecoveryInformation para recuperar as informações. |
OpenEnlistment | Abre um objeto de inscrição existente e retorna um identificador para a inscrição. |
ReadOnlyEnlistment | Solicita que o alistamento especificado seja convertido em um alistamento somente leitura. Uma inscrição somente leitura não pode participar do resultado da transação e não é registrada para recuperação. |
RollbackEnlistment | Reverte a transação especificada associada a uma inscrição. Essa função não pode ser chamada para alistamentos somente leitura. |
SetEnlistmentRecoveryInformation | Define uma estrutura opaca e definida pelo usuário de dados de recuperação da KTM. As informações de recuperação são armazenadas em um log em nome de um gerenciador de recursos (RM) chamando SetEnlistmentRecoveryInformation. Após uma falha, a RM pode usar GetEnlistmentRecoveryInformation para recuperar as informações. |
SinglePhaseReject | Indica que o gerenciador de recursos (RM) está recusando uma solicitação de fase única. Quando um TM (gerenciador de transações) recebe essa chamada, ele inicia uma confirmação em duas fases e envia uma solicitação de preparação para todas as RMs inscrita. |