Partager via

WillConnect, événement (ADO)

  • Article

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

s’applique à :'objet de connexion (ADO)

Syntaxe

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

Paramètres

connectionString
Chaîne qui contient des 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
Chaîne qui contient un mot de passe pour la connexion en attente.

options
Valeur long qui indique comment le fournisseur doit évaluer la 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. Elle est définie sur adStatusCantDeny si l’événement ne peut pas demander l’annulation de l’opération en attente.

Avant de retourner cet événement, 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
Objet Connection pour lequel cette notification d’événement s’applique. Les modifications apportées aux paramètres de l'connexion par le gestionnaire d’événements WillConnect WillConnect n’ont aucun effet sur le connexion.

Remarques

Lorsque WillConnect est appelé, les paramètres ConnectionString, UserID, Mot de passeet Options sont définies 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 renvoyer une demande d’annulation de la connexion en attente.

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

Voir aussi

modèle d’événements ADO (VC++)
résumé du gestionnaire d’événements ADO