WillConnect Event (ADO)

The WillConnect event is called before a connection starts.

Applies To: Connection Object (ADO)


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


A String that contains connection information for the pending connection.

A String that contains a user name for the pending connection.

A String that contains a password for the pending connection.

A Long value that indicates how the provider should evaluate the ConnectionString. Your only option is adAsyncOpen.

An EventStatusEnum status value.

When this event is called, this parameter is set to adStatusOK by default. It is set to adStatusCantDeny if the event cannot request cancellation of the pending operation.

Before this event returns, set this parameter to adStatusUnwantedEvent to prevent subsequent notifications. Set this parameter to adStatusCancel to request the connection operation that caused cancellation of this notification.

The Connection object for which this event notification applies. Changes to the parameters of the Connection by the WillConnect event handler will have no effect on the Connection.


When WillConnect is called, the ConnectionString, UserID, Password, and Options parameters are set to the values established by the operation that caused this event (the pending connection), and can be changed before the event returns. WillConnect may return a request that the pending connection be canceled.

When this event is canceled, ConnectComplete will be called with its adStatus parameter set to adStatusErrorsOccurred.

See Also

ADO Events Model Example (VC++)
ADO Event Handler Summary