ExecuteComplete 事件 (ADO)

系統會在命令完成執行後呼叫 ExecuteComplete 事件。

語法

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

參數

RecordsAffected
Long 值，指出受命令影響的記錄數目。

pError
Error 物件。 該物件會描述如果 adStatus 值為 adStatusErrorsOccurred 時所發生的錯誤；否則不會設定。

adStatus
EventStatusEnum 狀態值。 呼叫此事件時，如果造成事件的作業成功，此參數會設定為 adStatusOK，如果作業失敗，則會設定為 adStatusErrorsOccurred。

在此事件傳回之前，請將此參數設定為 adStatusUnwantedEvent 以防止後續的通知。

pCommand
已執行的 Command 物件。 即使在呼叫 Connection.Execute 或 Recordset.Open 時未明確建立 Command，仍會包含 Command 物件，而在此情況下，會由 ADO 在內部建立 Command 物件。

pRecordset
執行命令後所產生的 Recordset 物件。 此 Recordset 可能是空的。 請絕對不要從這個事件處理常式內終結此 Recordset 物件。 這麼做會導致 ADO 嘗試存取已不存在的物件時發生存取違規。

pConnection
Connection 物件。 用來執行作業的連線。

備註

ExecuteComplete 事件的可能發生原因包括 Connection.Execute、Command.Execute、Recordset.Open、Recordset.Requery 或 Recordset.NextRecordset 方法。

另請參閱

ADO 事件模型範例 (VC++)
ADO 事件處理常式摘要