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.

Funções de inscrição

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.