WillConnect 事件 (ADO)

在连接启动之前调用 WillConnect 事件。

适用于:连接对象(ADO)

语法

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

参数

ConnectionString
包含挂起连接的连接信息的 字符串

UserID
包含挂起连接的用户名的 字符串

密码
包含挂起连接密码的 字符串

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

adStatus
EventStatusEnum 状态值。

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

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

pConnection
此事件通知适用的 连接 对象。 WillConnect 事件处理程序对 Connection 参数的更改不会影响 Connection

言论

调用 WillConnect 时,ConnectionStringUserID密码,并将 选项 参数设置为导致此事件的操作(挂起的连接)建立的值,并且可以在事件返回之前进行更改。 WillConnect 可能会返回取消挂起连接的请求。

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

另请参阅

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