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 对象,在此情况下是通过 ADO 内部创建 Command 对象。

pRecordset
Recordset 对象是执行命令的结果。 此记录集可能为空。 不应从此事件处理程序中销毁此 Recordset 对象。 如果这样做,会在 ADO 尝试访问不再存在的对象时导致访问冲突。

pConnection
Connection 对象。 通过其执行操作的连接。

备注

Connection.Execute、Command.Execute、Recordset.Open、Recordset.Requery 或 Recordset.NextRecordset 方法可能会导致 ExecuteComplete 事件发生。

另请参阅

ADO 事件模型示例 (VC++)
ADO 事件处理程序摘要