ExecuteComplete-Ereignis (ADO)

Das ExecuteComplete--Ereignis wird aufgerufen, nachdem ein Befehl die Ausführung abgeschlossen hat.

Syntax

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

Parameter

RecordsAffected
Ein Long-Wert, der die Anzahl der datensätze angibt, die vom Befehl betroffen sind.

pError-
Ein Error-Objekt. Es beschreibt den Fehler, der aufgetreten ist, wenn der Wert von adStatus-adStatusErrorsOccurredist; andernfalls ist sie nicht festgelegt.

adStatus-
Ein EventStatusEnum Statuswert. Wenn dieses Ereignis aufgerufen wird, wird dieser Parameter auf adStatusOK- festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war, oder auf adStatusErrorsOccurred, wenn der Vorgang fehlgeschlagen ist.

Legen Sie vor dem Zurückgeben dieses Ereignisses diesen Parameter auf adStatusUnwantedEvent- fest, um nachfolgende Benachrichtigungen zu verhindern.

pCommand-
Das Command-Objekt, das ausgeführt wurde. Enthält ein Command -Objekt, auch wenn Connection.Execute oder Recordset.Open aufgerufen wird, ohne explizit ein Commandzu erstellen. In diesem Fall wird das Command -Objekt intern von ADO erstellt.

pRecordset-
Ein Recordset-Objekt, das das Ergebnis des ausgeführten Befehls ist. Dieses Recordset- ist möglicherweise leer. Sie sollten dieses Recordset-Objekt niemals innerhalb dieses Ereignishandlers zerstören. Dies führt zu einer Zugriffsverletzung, wenn ADO versucht, auf ein Objekt zuzugreifen, das nicht mehr vorhanden ist.

pConnection-
Ein Connection-Objekt. Die Verbindung, über die der Vorgang ausgeführt wurde.

Bemerkungen

Ein ExecuteComplete--Ereignis kann aufgrund der Connection auftreten.Ausführen von, Befehl.Execute, Recordset.Open, Recordset.requeryoder Recordset.NextRecordset--Methoden.

Siehe auch

ADO-Ereignismodell (Beispiel) (VC++)
ADO-Ereignishandlerzusammenfassung