Compartir a través de


Evento WillConnect (ADO)

Se aplica a: Access 2013, Office 2013

Al evento WillConnect se le llama antes de iniciarse una conexión.

Sintaxis

WillConnectConnectionString, UserID, Password, Options, adStatus, pConnection

Parámetros

Parámetro Descripción
ConnectionString String que contiene información de conexión para la conexión pendiente.
UserID String que contiene un nombre de usuario para la conexión pendiente.
Password String que contiene una contraseña para la conexión pendiente.
Opciones Valor Long que indica cómo debe evaluar el proveedor el valor ConnectionString. La única opción es adAsyncOpen.
adStatus EventStatusEnum. Cuando el evento recibe una llamada, este parámetro se establece de forma predeterminada en adStatusOK. Si el evento no puede solicitar la cancelación de la operación pendiente, el parámetro se establece en adStatusCantDeny.

Antes de que este evento regrese, establezca este parámetro en adStatusUnwantedEvent para impedir notificaciones posteriores. Establezca este parámetro como adStatusCancel para solicitar la operación de conexión que provocó la cancelación de esta notificación.
pConnection Objeto Connection al que se aplica esta notificación de eventos. Los cambios en los parámetros de Connection debidos al controlador del evento WillConnect no tendrán efecto en el objeto Connection.

Comentarios

Cuando se llama al evento WillConnect, los parámetros WillConnect, UserID, Password y Options toman 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 petición para cancelar la conexión pendiente.

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