Inscrições

Um Gerenciador de recursos se relaciona em uma transação quando começa a participar dessa 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 alista em uma transação. Esse objeto sinaliza para KTM que o Gerenciador de recursos (RM) está solicitando notificações sobre a transação especificada.

O RM fornece uma estrutura de _ máscara de notificação que detalha quais notificações ele está solicitando.

Funções de inscrição

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

Função Descrição
CommitComplete Indica que um Gerenciador de recursos (RM) concluiu a confirmação de uma transação que foi solicitada pelo Gerenciador de transações (TM).
Subinscrição Cria uma inscrição, 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, o 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 a inscrição especificada seja convertida em uma inscrição somente leitura. Uma inscrição somente leitura não pode participar do resultado da transação e não é permanentemente registrada para recuperação.
RollbackEnlistment Reverte a transação especificada que está associada a uma inscrição. Esta função não pode ser chamada para inlistagens somente leitura.
SetEnlistmentRecoveryInformation Define uma estrutura opaca e 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 Gerenciador de recursos (RM) está recusando uma solicitação de fase única. Quando um Gerenciador de transação (TM) recebe essa chamada, ele inicia uma confirmação de duas fases e envia uma solicitação de preparação para todos os RMs inscritos.