Freigeben über

WillConnect-Ereignis (ADO)

  • Artikel

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

gilt für:Connection-Objekt (ADO)

Syntax

  
WillConnect ConnectionString, UserID, Password, Options, adStatus, pConnection

Parameter

ConnectionString-
Eine Zeichenfolge, die Verbindungsinformationen für die ausstehende Verbindung enthält.

UserID-
Eine Zeichenfolge, die einen Benutzernamen für die ausstehende Verbindung enthält.

Kennwort
Eine Zeichenfolge, die ein Kennwort für die ausstehende Verbindung enthält.

Optionen
Ein Long-Wert, der angibt, wie der Anbieter die ConnectionString-auswerten soll. Ihre einzige Option ist adAsyncOpen.

adStatus-
Ein EventStatusEnum Statuswert.

Wenn dieses Ereignis aufgerufen wird, wird dieser Parameter standardmäßig auf adStatusOK- festgelegt. Sie ist auf adStatusCantDeny- festgelegt, wenn das Ereignis den Abbruch des ausstehenden Vorgangs nicht anfordern kann.

Legen Sie vor dem Zurückgeben dieses Ereignisses diesen Parameter auf adStatusUnwantedEvent- fest, um nachfolgende Benachrichtigungen zu verhindern. Legen Sie diesen Parameter auf adStatusCancel fest, um den Verbindungsvorgang anzufordern, der den Abbruch dieser Benachrichtigung verursacht hat.

pConnection-
Das Connection-Objekt, für das diese Ereignisbenachrichtigung gilt. Änderungen an den Parametern der Connection durch den WillConnect-Ereignishandler haben keine Auswirkungen auf das Connection.

Bemerkungen

Wenn WillConnect- aufgerufen wird, werden die ConnectionString-, UserID-, Kennwort-und Optionen Parameter auf die Werte festgelegt, die durch den Vorgang erstellt wurden, der dieses Ereignis verursacht hat (die ausstehende Verbindung), und kann vor dem Zurückgeben des Ereignisses geändert werden. WillConnect- kann eine Anforderung zurückgeben, dass die ausstehende Verbindung abgebrochen wird.

Wenn dieses Ereignis abgebrochen wird, wird ConnectComplete- mit dem adStatus Parameter aufgerufen, der auf adStatusErrorsOccurredfestgelegt ist.

Siehe auch

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