ExecuteComplete-Ereignis (ADO)

  • Artikel

Das ExecuteComplete-Ereignis wird aufgerufen, nachdem die Ausführung eines Befehls abgeschlossen wurde.

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. Dieser Parameter enthält eine Beschreibung des aufgetretenen Fehlers, wenn adStatus den Wert adStatusErrorsOccurred aufweist. Andernfalls ist er 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.

Bevor dieses Ereignis zurückgegeben wird, legen Sie diesen Parameter auf adStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern.

pCommand
Das Command-Objekt, das ausgeführt wurde. Enthält ein Command-Objekt, sogar beim Aufrufen von Connection.Execute oder Recordset.Open, ohne explizit ein Command-Objekt zu erstellen, wobei in solchen Fällen das Command-Objekt intern von ADO erstellt wird.

pRecordset
Ein Recordset-Objekt, das das Ergebnis des ausgeführten Befehls ist. Dieses Recordset kann leer sein. Sie sollten dieses Recordset-Objekt niemals innerhalb dieses Ereignishandlers zerstören. Dies würde zu einer Zugriffsverletzung führen, 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 wegen der Methoden Connection.Execute, Command.Execute, Recordset.Open, Recordset.Requery oder Recordset.NextRecordset auftreten.

Weitere Informationen

ADO-Ereignismodell – Beispiel (VC++)
ADO-Ereignishandler – Übersicht