ExecuteComplete イベント (ADO)ExecuteComplete Event (ADO)

ExecuteCompleteイベントは、コマンドの実行が完了した後に呼び出されます。The ExecuteComplete event is called after a command has finished executing.

構文Syntax

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

パラメーターParameters

RecordsAffectedRecordsAffected
A長いコマンドによって影響を受けたレコード数を示す値。A Long value indicating the number of records affected by the command.

pErrorpError
エラーオブジェクト。An Error object. 場合に発生したエラーを説明の値adStatusadStatusErrorsOccurred; 未設定がそれ以外の場合。It describes the error that occurred if the value of adStatus is adStatusErrorsOccurred; otherwise it is not set.

adStatusadStatus
EventStatusEnum状態値。An EventStatusEnum status value. このパラメーターに設定されているこのイベントが呼び出されると、 adStatusOKイベントの原因となった操作が成功した場合またはadStatusErrorsOccurred操作に失敗した場合。When this event is called, this parameter is set to adStatusOK if the operation that caused the event was successful, or to adStatusErrorsOccurred if the operation failed.

このイベントから制御が戻る前に、このパラメーターを設定adStatusUnwantedEvent後続通知しないように設定します。Before this event returns, set this parameter to adStatusUnwantedEvent to prevent subsequent notifications.

pCommandpCommand
コマンドが実行されたオブジェクト。The Command object that was executed. 含まれています、コマンドオブジェクトの呼び出し時にもConnection.ExecuteまたはRecordset.Open明示的に作成せず、コマンド、どのような場合、コマンドオブジェクトは ADO によって内部的に作成します。Contains a Command object even when calling Connection.Execute or Recordset.Open without explicitly creating a Command, in which cases the Command object is created internally by ADO.

pRecordsetpRecordset
A Recordset実行されたコマンドの結果を表すオブジェクト。A Recordset object that is the result of the executed command. これは、 Recordset空にすることがあります。This Recordset may be empty. このイベント ハンドラー内からこのレコード セット オブジェクトは破棄しないでください。You should never destroy this Recordset object from within this event handler. ADO が、存在しなくなったオブジェクトにアクセスしようとしています。 これがアクセス違反に発生します。Doing so will result in an Access Violation when ADO tries to access an object that no longer exists.

pConnectionpConnection
A接続オブジェクト。A Connection object. 操作の実行を接続します。The connection over which the operation was executed.

コメントRemarks

ExecuteCompleteためにイベントが発生する、接続実行コマンド実行レコード セットオープンレコード セットRequery、またはレコード セットNextRecordsetメソッド。An ExecuteComplete event may occur due to the Connection.Execute, Command.Execute, Recordset.Open, Recordset.Requery, or Recordset.NextRecordset methods.

関連項目See Also

ADO イベント モデルの例 (vc++) ADO Events Model Example (VC++)
ADO イベント ハンドラーの概要ADO Event Handler Summary