Funções do Gerenciador de Transações do Kernel

  • Artigo

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

Função Descrição
Committransaction Solicita que a transação especificada seja confirmada.
CommitTransactionAsync Solicita que a transação especificada seja confirmada.
Createtransaction Cria um novo objeto de transação.
GetTransactionId Obtém a ID da transação especificada.
GetTransactionInformation Retorna as informações solicitadas sobre a transação especificada.
OpenTransaction Abre uma transação existente.
RollbackComplete Indica que o gerenciador de recursos (RM) concluiu com êxito a reversão de uma transação.
RollbackTransaction Solicita que a transação especificada seja revertida.
RollbackTransactionAsync Solicita que a transação especificada seja revertida. Essa função retorna de forma assíncrona.
SetTransactionInformation Define as informações de transação para a transação especificada.

 

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

Função Descrição
CommitComplete Indica que uma RM terminou de confirmar uma transação que foi solicitada pelo TM (gerenciador de transações).
CommitEnlistment Confirma a transação para a inscrição especificada.
GetEnlistmentId Obtém a ID para a inscrição especificada.
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 uma 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.
PrepareEnlistment Chamado por TM superior para indicar que o trabalho de pré-preparação foi concluído.
PrePrepareEnlistment Chamado por TM superior para indicar que o trabalho de pré-preparação foi concluído.
RecoverEnlistment Recupera o estado de um 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 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 uma RM chamando SetEnlistmentRecoveryInformation. Após uma falha, a RM pode usar GetEnlistmentRecoveryInformation para recuperar as informações.
SinglePhaseReject Indica que a RM está recusando uma solicitação de fase única. Quando um TM recebe essa chamada, ele inicia um commit em duas fases e envia uma solicitação de preparação para todos os RMs inscritos.

 

As funções a seguir são usadas com gerenciadores de recursos.

Função Descrição
CreateResourceManager Cria um novo objeto RM e associa o RM a um TM (gerenciador de transações).
GetNotificationResourceManager Solicita e recebe uma notificação para RM. Essa função é usada pelo registro RM para receber notificações quando uma transação altera o estado.
GetNotificationResourceManagerAsync Solicita e recebe uma notificação assíncrona para um RM. Essa função é usada pelo RM para se registrar para receber notificações quando uma transação altera o estado.
OpenResourceManager Abre uma RM existente.
PrepareComplete Indica que a RM concluiu todo o processamento necessário para garantir que uma operação de confirmação ou anulação terá êxito para a transação especificada.
PrePrepareComplete Sinaliza que essa RM concluiu seu trabalho de pré-preparação para que outras RMs agora possam iniciar suas operações de preparação.
RecoverResourceManager Recupera o estado de uma RM de seu arquivo de log.
SetResourceManagerCompletionPort Associa a porta de conclusão de E/S especificada ao RM especificado. Essa porta recebe todas as notificações para a RM.

 

As funções a seguir são usadas com gerenciadores de transações.

Função Descrição
CreateTransactionManager Cria um novo objeto TM e retorna um identificador com o acesso especificado.
GetCurrentClockTransactionManager Obtém um valor de relógio virtual de um TM.
GetTransactionManagerId Obtém um identificador para o TM especificado.
OpenTransactionManager Abre um TM existente.
OpenTransactionManagerById Abre um TM existente.
RecoverTransactionManager Recupera o estado de uma TM de seu arquivo de log.
RenameTransactionManager Renomeia um TM.
RollforwardTransactionManager Recupera o estado da TM de seu arquivo de log para o valor do relógio virtual especificado.