Inscrições

Um gerenciador de recursos é inscrito 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 insere em uma transação. Esse objeto sinaliza à KTM que o gerenciador de recursos (RM) está solicitando notificações sobre a transação especificada.

O RM fornece uma estrutura NOTIFICATION_MASK que detalha quais notificações ele está solicitando.

Funções de inscrição

As funções a seguir são usadas com alistamentos.

Função Descrição
CommitComplete Indica que um RM (gerenciador de recursos) 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 o alistamento 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 RM (gerenciador de recursos) chamando a função SetEnlistmentRecoveryInformation . Após uma falha, o RM pode usar a função GetEnlistmentRecoveryInformation para recuperar as informações.
OpenEnlistment Abre um objeto de alistamento existente e retorna um identificador para o alistamento.
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 de forma durável para recuperação.
RollbackEnlistment Reverte a transação especificada associada a um alistamento. Essa função não pode ser chamada para alistamentos somente leitura.
SetEnlistmentRecoveryInformation Define uma estrutura opaca definida pelo usuário de dados de recuperação do KTM. As informações de recuperação são armazenadas em um log em nome de um RM (gerenciador de recursos) chamando SetEnlistmentRecoveryInformation. Após uma falha, o RM pode usar GetEnlistmentRecoveryInformation para recuperar as informações.
SinglePhaseReject Indica que o RM (gerenciador de recursos) 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 todos os RMs inscritos.