Partager via


Événement WillConnect (ADO)

S’applique à : Access 2013, Office 2013

L'événement WillConnect est appelé avant le début d'une connexion.

Syntaxe

WillConnectConnectionString, UserID, Password, Options, adStatus, pConnection

Paramètres

Paramètre Description
ConnectionString Valeur de type String contenant les informations de la connexion en attente.
UserID Valeur de type String reprenant le nom de l'utilisateur de la connexion en attente.
Password Valeur de type String contenant un mot de passe pour la connexion en attente.
Options Valeur de type Long indiquant la méthode d'évaluation du paramètre ConnectionString par le fournisseur. La seule option possible est adAsyncOpen.
adStatus EventStatusEnum. Lorsque cet événement est appelé, ce paramètre est défini à adStatusOK par défaut. Il est défini à adStatusCantDeny si l'événement ne peut pas demander l'annulation de l'opération en attente.

Avant que cet événement soit retourné, affectez la valeur adStatusUnwantedEvent à ce paramètre pour éviter toute notification ultérieure. Définissez ce paramètre sur adStatusCancel pour demander l’opération de connexion qui a provoqué l’annulation de cette notification.
pConnection Objet Connection auquel cette notification d'événement s'applique. Les modifications apportées aux paramètres de l’objet Connection par le gestionnaire d’événements WillConnect n’ont aucun effet sur l’objet Connection.

Remarques

Si WillConnect est appelé, les paramètres ConnectionString, UserID, Password et Options prennent les valeurs établies par l'opération à l'origine de l'événement (à savoir, la connexion en attente) et ne peuvent pas être modifiés tant que l'événement n'est pas retourné. Il se peut que le gestionnaire d'événements WillConnect renvoie une demande d'annulation de la connexion en attente.

Si c'est le cas, ConnectComplete est alors appelé et son paramètre adStatus est affecté de la valeur adStatusErrorsOccurred.