BeginTransComplete、CommitTransComplete、および RollbackTransComplete のイベント (ADO)

  • [アーティクル]

これらのイベントは、Connection オブジェクトでの関連付けられた操作の実行が完了した後に呼び出されます。

  • BeginTransComplete が BeginTrans 操作の後に呼び出されます。

  • CommitTransComplete が CommitTrans 操作の後に呼び出されます。

  • RollbackTransComplete が RollbackTrans 操作の後に呼び出されます。

構文

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

パラメーター

TransactionLevel
このイベントの原因となった BeginTrans の新しいトランザクション レベルを含む Long 値。

pError
Error オブジェクト。 EventStatusEnum の値が adStatusErrorsOccurred の場合に発生したエラーの説明です。それ以外の場合は設定されません。

adStatus
EventStatusEnum の状態値。 これらのイベントのいずれかが呼び出されると、イベントの原因となった操作が成功した場合はこのパラメーターが adStatusOK に設定され、操作が失敗した場合は adStatusErrorsOccurred に設定されます。

これらのイベントは、イベントが返される前にこのパラメーターを adStatusUnwantedEvent に設定することで、後続の通知を防ぐことができます。

pConnection
このイベントが発生した Connection オブジェクト。

注釈

Visual C++ では、複数の Connections で同じイベント処理メソッドを共有できます。 このメソッドは、返された Connection オブジェクトを使用して、イベントの原因となったオブジェクトを特定します。

Attributes プロパティが adXactCommitRetaining または adXactAbortRetaining に設定されている場合、トランザクションのコミットまたはロールバック後に新しいトランザクションが開始されます。 BeginTransComplete イベントを使用して、最初のトランザクション開始イベント以外のすべてを無視します。

参照

ADO イベント モデルの例 (VC++)
BeginTrans、CommitTrans、および RollbackTrans メソッドの例 (VB)
ADO イベント ハンドラーの概要
BeginTrans、CommitTrans、および RollbackTrans メソッド (ADO)