Condividi tramite

Evento WillConnect (ADO)

  • Articolo

L'evento WillConnect viene chiamato prima dell'avvio di una connessione.

Si applica a: Oggetto Connection (ADO)

Sintassi

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

Parametri

ConnectionString
Stringa che contiene le informazioni di connessione per la connessione in sospeso.

UserID
Stringa contenente un nome utente per la connessione in sospeso.

Password
Stringa contenente una password per la connessione in sospeso.

Opzioni
Valore Long che indica in che modo il provider deve valutare ConnectionString. L'unica opzione è adAsyncOpen.

adStatus
Valore di stato EventStatusEnum.

Quando viene chiamato questo evento, per impostazione predefinita questo parametro è impostato su adStatusOK. Viene impostato su adStatusCantDeny se l'evento non può richiedere l'annullamento dell'operazione in sospeso.

Prima di restituire questo evento, impostare questo parametro su adStatusUnwantedEvent per impedire le notifiche successive. Impostare questo parametro su adStatusCancel per richiedere l'operazione di connessione che ha causato l'annullamento di questa notifica.

pConnection
Oggetto Connection per il quale si applica questa notifica di evento. Le modifiche ai parametri di Connection apportate dal gestore eventi WillConnect di non avranno alcun effetto su Connection.

Osservazioni:

Quando viene chiamato WillConnect, i parametri ConnectionString, UserID, Password e Options vengono impostati sui valori stabiliti dall'operazione che ha generato questo evento (la connessione in sospeso) e possono essere modificati prima che l'evento restituisca un valore. WillConnect può restituire una richiesta che la connessione in sospeso venga annullata.

Quando questo evento viene annullato, ConnectComplete verrà chiamato con il relativo parametro adStatus impostato su adStatusErrorsOccurred.

Vedi anche

Esempio di modello di eventi ADO (VC++)
Riepilogo dei gestori eventi ADO