Die Ereignisse BeginTransComplete, CommitTransComplete und RollbackTransComplete (ADO)

  • Artikel

Diese Ereignisse werden aufgerufen, nachdem die Ausführung des zugeordneten Vorgangs am Connection-Objekt fertig gestellt wurde.

  • BeginTransComplete wird nach dem BeginTrans-Vorgang aufgerufen.

  • CommitTransComplete wird nach dem CommitTrans-Vorgang aufgerufen.

  • RollbackTransComplete wird nach dem RollbackTrans-Vorgang aufgerufen.

Syntax

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

Parameter

TransactionLevel
Ein Long-Wert, der die neue Transaktionsebene des BeginTrans-Vorgangs enthält, der dieses Ereignis verursacht hat.

pError
Ein Error-Objekt. Es beschreibt den Fehler, der aufgetreten ist, wenn der Wert von „EventStatusEnum“ adStatusErrorsOccurred ist. Andernfalls ist es nicht festgelegt.

adStatus
Ein EventStatusEnum-Statuswert. Wenn eins dieser Ereignisse aufgerufen wird, wird dieser Parameter auf adStatusOK festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war, oder auf adStatusErrorsOccurred, wenn der Vorgang fehlgeschlagen ist.

Diese Ereignisse können nachfolgende Benachrichtigungen verhindern, indem dieser Parameter auf adStatusUnwantedEvent festgelegt wird, bevor das Ereignis zurückgegeben wird.

pConnection
Das Connection-Objekt, für das dieses Ereignis aufgetreten ist.

Bemerkungen

In Visual C++können mehrere Verbindungen dieselbe Ereignisbehandlungsmethode gemeinsam nutzen. Die Methode verwendet das zurückgegebene Connection-Objekt, um zu bestimmen, welches Objekt das Ereignis verursacht hat.

Wenn die Attributes-Eigenschaft auf adXactCommitRetaining oder adXactAbortRetaining festgelegt ist, startet eine neue Transaktion nach dem Committen oder Rollback einer Transaktion. Verwenden Sie das BeginTransComplete-Ereignis, um alle Ereignisse außer dem ersten Transaktionsstartereignis zu ignorieren.

Weitere Informationen

ADO-Ereignismodell – Beispiel (VC++)
BeginTrans-, CommitTrans- und RollbackTrans-Methode – Beispiel (VB)
ADO-Ereignishandler – Übersicht
BeginTrans-, CommitTrans- und RollbackTrans-Methode (ADO)