Evento WillConnect (ADO)

Se llama al evento WillConnect antes de que se inicie una conexión.

Se aplica a:objeto Connection (ADO)

Sintaxis

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

Parámetros

ConnectionString
Cadena que contiene información de conexión para la conexión pendiente.

UserID
Cadena que contiene un nombre de usuario para la conexión pendiente.

Contraseña
Cadena que contiene una contraseña para la conexión pendiente.

Opciones
Valor Long que indica cómo el proveedor debe evaluar ConnectionString. La única opción es adAsyncOpen.

adStatus
Valor de estado EventStatusEnum.

Cuando se llama a este evento, este parámetro se establece en adStatusOK de forma predeterminada. Se establece en adStatusCantDeny si este evento no puede solicitar la cancelación de la operación pendiente.

Antes de que este evento vuelva, establezca este parámetro en adStatusUnwantedEvent para evitar notificaciones posteriores. Establezca este parámetro en adStatusCancel para solicitar la operación de conexión que provocó la cancelación de esta notificación.

pConnection
Objeto Connection para el que se aplica esta notificación de eventos. Los cambios realizados en los parámetros de Connection por el controlador de eventos WillConnect no tendrán ningún efecto en Connection.

Comentarios

Cuando se llama a WillConnect, los parámetros ConnectionString, UserID, Password y Options se establecen en los valores establecidos por la operación que provocó este evento (la conexión pendiente) y se pueden cambiar antes de que el evento vuelva. WillConnect puede devolver una solicitud de cancelación de la conexión pendiente.

Cuando se cancela este evento, se llamará a ConnectComplete con su parámetro adStatus establecido en adStatusErrorsOccurred.

Consulte también

Ejemplo de modelo de eventos de ADO (VC ++)
Conexión ADO y los eventos de conjunto de registros