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

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.