Tutorials References Menu

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