BeginTransComplete, CommitTransComplete, and RollbackTransComplete (ConnectionEvent) Methods (ADO)

See Also   Applies To

These Event handling methods will be called after the associated operation on the Connection object finishes executing.

Syntax

BeginTransComplete TransactionLevel, pError, adStatus, pConnection

CommitTransComplete pError, adStatus, pConnection

RollbackTransComplete pError, adStatus, pConnection

Parameters

TransactionLevel   A Long. Contains the new transaction level of the BeginTrans that caused this event.

pError   An Error object. It describes the error that occurred if the value of EventStatusEnum is adStatusErrorsOccurred; otherwise it is not set.

adStatus   An EventStatusEnum status value. When any of these methods is called, this parameter is set to adStatusOK if the operation that caused the event was successful, or adStatusErrorsOccurred if the operation failed.

These methods can prevent subsequent notifications by setting this parameter to adStatusUnwantedEvent before the method returns.

pConnection   The Connection object for which this event occurred.

Remarks

In Visual C++ multiple Connections can share the same event handling method. The method uses the returned Connection object to determine which object caused the event.

If the Attributes property is set to adXactCommitRetaining or adXactAbortRetaining, a new transaction is started after committing or rolling back a transaction. Use the BeginTransComplete event handler routine to ignore all but the first transaction start event.