WillConnect 事件 (ADO)

适用于:Access 2013、Office 2013

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

语法

WillConnectConnectionStringUserIDPasswordOptionsadStatuspConnection

参数

参数 说明
ConnectionString 字符串型 ,包含挂起的连接的连接信息。
UserID 字符串型 ,包含挂起的连接的用户名。
Password 字符串型 ,包含挂起的连接的密码。
选项 长整型值,指示提供程序应如何对 ConnectionString 求值。 您仅有的选项为 adAsyncOpen
adStatus EventStatusEnum。 调用此事件时,默认情况下该参数设置为 adStatusOK。 如果此事件无法请求取消挂起的操作,则该参数设置为 adStatusCantDeny

在此事件返回之前,将该参数设置为 adStatusUnwantedEvent 可以阻止随后进行通知。 将该参数设置为 adStatusCancel 将请求导致取消此通知的连接操作。
pConnection 为其应用该事件通知的 Connection 对象。 WillConnect 事件处理程序对 Connection 的参数所做的更改对 Connection 将没有效果。

备注

调用 WillConnect 时,ConnectionStringUserIDPasswordOptions 参数设置为由导致该事件的操作(挂起的连接)建立的值,且这些值可以在事件返回之前更改。 WillConnect 可以返回取消挂起的连接的请求。

取消此事件时,将调用 adStatus 参数设置为 adStatusErrorsOccurredConnectComplete