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
Dies ist eine Zeichenfolge, die Verbindungsinformationen für die ausstehende Verbindung enthält.

UserID
Dies ist eine Zeichenfolge, die einen Benutzernamen für die ausstehende Verbindung enthält.

Kennwort
Dies ist eine Zeichenfolge, die ein Kennwort für die ausstehende Verbindung enthält.

Optionen
Dies ist ein Long-Wert, der angibt, wie der Anbieter das ConnectionString-Objekt auswerten soll. Ihre einzige Option ist adAsyncOpen.

adStatus
Ein EventStatusEnum-Statuswert.

Wenn dieses Ereignis aufgerufen wird, wird dieser Parameter standardmäßig auf adStatusOK festgelegt. Er wird auf adStatusCantDeny festgelegt, wenn das Ereignis keinen Abbruch des ausstehenden Vorgangs anfordern kann.

Legen Sie diesen Parameter vor der Rückgabe des Ereignisses auf adStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern. Legen Sie diesen Parameter auf adStatusCancel fest, um den Verbindungsvorgang anzufordern, der zu einer Kündigung dieser Benachrichtigung führte.

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

Bemerkungen

Wenn WillConnect aufgerufen wird, werden die Parameter ConnectionString, UserID, Password und Options auf die Werte festgelegt, die durch den Vorgang erstellt wurden, der dieses Ereignis verursacht hat (die ausstehende Verbindung). Die Parameter können geändert werden, bevor das Ereignis zurückgegeben werden. WillConnect kann eine Anforderung zurückgeben, sodass die ausstehende Verbinden abgebrochen wird.

Wenn dieses Ereignis abgebrochen wird, wird ConnectComplete mit seinem adStatus-Parameter aufgerufen, der auf adStatusErrorsOccurred festgelegt ist.

Weitere Informationen

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