ExecuteComplete イベント (ADO)

ExecuteComplete イベントは、コマンドが実行を終了した後に呼び出されます。

構文

ExecuteComplete RecordsAffected, pError, adStatus, pCommand, pRecordset, pConnection  

パラメーター

RecordsAffected
コマンドの影響を受けるレコードの数を示す Long 値。

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

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

このイベントが返される前に、このパラメーターを adStatusUnwantedEvent に設定して、後続の通知を防ぎます。

pCommand
実行された Command オブジェクト。 明示的に Command を作成せずに Connection.Execute または Recordset.Open を呼び出すときでも Command オブジェクトが含まれます。この場合、Command オブジェクトは ADO によって内部で作成されます。

pRecordset
実行されたコマンドの結果である Recordset オブジェクト。 この Recordset は空の場合があります。 この Recordset オブジェクトをこのイベント ハンドラー内から破棄しないでください。 これを行うと、ADO がアクセスしようとしたオブジェクトが存在していないとき、アクセス違反になります。

pConnection
Connection オブジェクト。 操作が実行された接続。

注釈

Connection.Execute、Command.Execute、Recordset.Open、Recordset.Requery、または Recordset.NextRecordset メソッドが原因で ExecuteComplete イベントが発生する場合があります。

参照

ADO イベント モデルの例 (VC++)
ADO イベント ハンドラーの概要