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。