Partager via

WillConnect, événement (ADO)

  • Article

L’événement WillConnect est appelé avant le démarrage d’une connexion.

S’applique à : Objet connection (ADO)

Syntaxe

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

Paramètres

ConnectionString
Chaîne qui contient les informations de connexion pour la connexion en attente.

UserID
Chaîne qui contient un nom d’utilisateur pour la connexion en attente.

Mot de passe
Une Chaîne qui contient un mot de passe pour la connexion en attente.

Options
Valeur long qui indique comment le fournisseur doit évaluer ConnectionString. Votre seule option est adAsyncOpen.

adStatus
Valeur d’état EventStatusEnum.

Lorsque cet événement est appelé, ce paramètre est défini sur adStatusOK par défaut. Il est défini sur adStatusCantDeny si cet événement ne peut pas demander l’annulation de l’opération en attente.

Avant que cet événement retourne un résultat, définissez ce paramètre sur adStatusUnwantedEvent pour empêcher les notifications suivantes. Définissez ce paramètre sur adStatusCancel pour demander l’opération de connexion qui a provoqué l’annulation de cette notification.

pConnection
L'objet Connexion pour lequel cette notification d'événement s'applique. Les modifications apportées aux paramètres de la connexion par le gestionnaire d’événements WillConnect n’ont aucun effet sur la connexion.

Notes

Lorsque WillConnect est appelé, les paramètres ConnectionString, UserID, Password et Options sont définis sur les valeurs établies par l’opération qui a provoqué cet événement (la connexion en attente) et peut être modifiée avant le retour de l’événement. WillConnect peut retourner une demande d’annulation de la connexion en attente.

Lorsque cet événement est annulé, ConnectComplete est appelé avec son paramètre adStatus défini sur adStatusErrorsOccurred.

Voir aussi

Exemple de modèle d’événements ADO (VC ++)
Présentation rapide du gestionnaire d’événements ADO