Compartilhar via


Eventos BeginTransComplete, CommitTransComplete e RollbackTransComplete (ADO)

Esses eventos serão chamados depois que a operação associada no objeto Connection terminar de ser executada.

  • BeginTransComplete é chamado após a operação BeginTrans.

  • CommitTransComplete é chamado após a operação CommitTrans.

  • RollbackTransComplete é chamado após a operação RollbackTrans.

Sintaxe

  
BeginTransComplete TransactionLevel, pError, adStatus, pConnection  
CommitTransComplete pError, adStatus, pConnection  
RollbackTransComplete pError, adStatus, pConnection  

Parâmetros

TransactionLevel
Um valor Long que contém o novo nível de transação do BeginTrans que causou esse evento.

pError
Um objeto Error. Ele descreve o erro que ocorreu se o valor de EventStatusEnum for adStatusErrorsOccurred, caso contrário, ele não é definido.

adStatus
Um valor de status EventStatusEnum. Quando qualquer um desses eventos é chamado, esse parâmetro é definido como adStatusOK se a operação que causou o evento foi bem-sucedida ou como adStatusErrorsOccurred se houve uma falha na operação.

Esses eventos podem impedir notificações subsequentes definindo esse parâmetro como adStatusUnwantedEvent antes que o evento retorne.

pConnection
O objeto Connection para o qual esse evento ocorreu.

Comentários

No Visual C++, várias Conexões podem compartilhar o mesmo método de tratamento de eventos. O método usa o objeto Connection retornado para determinar qual objeto causou o evento.

Se a propriedade Attributes for definida como adXactCommitRetaining ou adXactAbortRetaining, uma nova transação será iniciada após a confirmação ou reversão de uma transação. Use o evento BeginTransComplete para ignorar todos, exceto o primeiro evento de início da transação.

Consulte Também

Exemplo do modelo de eventos ADO (VC++)
Exemplo dos métodos BeginTrans, CommitTrans e RollbackTrans (VB)
Resumo do manipulador de eventos ADO
Métodos BeginTrans, CommitTrans e RollbackTrans (ADO)