ADO WillConnect, ConnectComplete, and Disconnect Events
❮ Complete Connection Object Reference
An event is a subroutine that can be called automatically after a specific operation has occurred.
- The WillConnect event can be fired before a connection starts.
- The ConnectComplete event can be fired after a connection starts.
- The Disconnect event can be fired after a connection ends.
Syntax
WillConnect ConnectionString,userid,psword,options,status,objcon
ConnectComplete objerror,status,objconn
Disconnect status,objconn
Parameter | Description |
---|---|
ConnectionString | A string that contains the information required for the connection |
userid | A string that contains the user name for the connection |
psword | A string that contains the password for the connection |
options | A long value that specifies how the provider should evaluate the ConnectionString. Can only be set to adAsyncOpen |
objerror | An Error object that contains the errors that occurred
Note: The EventStatusEnum value must be set to adStatusErrorsOccurred to create the Error object |
status | An EventStatusEnum value.
Default is adStatusOK
However, when the ConnectComplete event is called, this parameter is set to adStatusCancel IF a WillConnect event calls for cancelling of the pending connection |
objconn | The Connection object that fired the event |
EventStatusEnum Values
Constant | Value | Description |
---|---|---|
adStatusOK | 1 | The operation that fired the event was successful |
adStatusErrorsOccurred | 2 | The operation that fired the event failed |
adStatusCantDeny | 3 | Cannot cancel the pending operation |
adStatusCancel | 4 | Cancels the operation that fired the event |
adStatusUnwantedEvent | 5 | Prevents subsequent notifications before the event method has finished executing |
❮ Complete Connection Object Reference