Freigeben über


WillConnect-Ereignis (ADO)

Gilt für: Access 2013, Office 2013

Das WillConnect-Ereignis wird aufgerufen, bevor eine Verbindung gestartet wird.

Syntax

WillConnectConnectionString, UserID, Password, Options, adStatus, pConnection

Parameter

Parameter Beschreibung
ConnectionString Ein String -Wert, der Verbindungsinformationen für die ausstehende Verbindung enthält.
UserID Ein String -Wert, der einen Benutzernamen für die ausstehende Verbindung enthält.
Password Ein String -Wert, der ein Kennwort für die ausstehende Verbindung enthält.
Optionen Ein Long-Wert, der angibt, wie ConnectionString vom Anbieter ausgewertet werden soll. Die einzige Option ist adAsyncOpen.
adStatus EventStatusEnum. Beim Aufrufen dieses Ereignisses wird dieser Parameter standardmäßig auf adStatusOK festgelegt. Der Parameter wird auf adStatusCantDeny festgelegt, wenn das Ereignis den Abbruch des ausstehenden Vorgangs nicht anfordern kann.

Legen Sie diesen Parameter vor der Rückgabe dieses Ereignisses auf AdStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern. Legen Sie diesen Parameter auf adStatusCancel fest, um den Verbindungsvorgang anzufordern, der zum Abbruch dieser Benachrichtigung geführt hat.
pConnection Das Connection-Objekt, für das diese Ereignisbenachrichtigung gilt. Vom WillConnect-Ereignishandler vorgenommene Änderungen an den Parametern des Connection-Objekts haben keine Auswirkungen auf das Connection-Objekt.

Hinweise

Wenn WillConnect aufgerufen wird, werden die Parameter ConnectionString, UserID, Password und Options auf die Werte festgelegt, die durch den Vorgang festgelegt wurden, der dieses Ereignis verursacht hat (die ausstehende Verbindung). Sie können geändert werden, bevor das Ereignis zurückgegeben wird. WillConnect gibt möglicherweise eine Anforderung zurück, dass die ausstehende Verbindung abgebrochen wird.

Wird dieses Ereignis abgebrochen, wird ConnectComplete aufgerufen, wobei für den adStatus-Parameter adStatusErrorsOccurred festgelegt ist.