WillConnect 事件 (ADO)

在启动连接前调用 WillConnect 事件

适用于:连接对象(ADO)

语法

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

参数

ConnectionString
一个字符串,其中包含挂起的连接的连接信息

UserID
一个字符串,其中包含挂起的连接的用户名

密码
一个字符串,其中包含挂起的连接的密码

选项
一个长值,该值指示提供程序应如何评估 ConnectionString。 唯一的选项是 adAsyncOpen

adStatus
EventStatusEnum 状态值。

调用此事件时,此参数默认设置为 adStatusOK。 如果事件无法请求取消挂起的操作,则设置为 adStatusCantDeny

在返回此事件之前,请将此参数设置为 adStatusUnwantedEvent 以防止后续通知。 将此参数设置为 adStatusCancel 以请求导致了此通知被取消的连接操作

pConnection
应用此事件通知的 Connection 对象。 WillConnect 事件处理程序对 Connection 的参数所做的更改不会影响该 Connection

注解

调用 WillConnect 时,ConnectionString、UserID、Password 和 Options 参数设置为由导致此事件(挂起的连接)的操作建立的值,并且可以在该事件返回之前进行更改。 WillConnect 可返回取消挂起连接的请求

取消此事件后,将调用 ConnectComplete,其 adStatus 参数将设置为 adStatusErrorsOccurred

另请参阅

ADO 事件模型示例 (VC++)
ADO 事件处理程序摘要