WillConnect (ConnectionEvent) Method

   

该方法在连接启动前调用。在挂起连接中使用的参数将作为输入参数提供，并可在方法返回之前进行更改。该方法可以返回取消挂起连接的请求。

语法

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

参数

ConnectionString   字符串，包含有关挂起连接的连接信息。

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

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

Options   长整型值，指明提供者应如何计算 ConnectionString。只能选择 adAsyncOpen。

adStatus   EventStatusEnum 状态值。

当调用该方法时，如果引发事件的操作成功，则该参数设置为 adStatusOK。如果该方法无法请求取消挂起的操作，那么该参数设置为 adStatusCantDeny。

在该方法返回前，将该参数设置为 adStatusUnwantedEvent 以避免后续的通知。将该参数设置为 adStatusCancel 以请求引起取消该通知的连接操作。

pConnection   该事件通知所针对的 Connection 对象。该 Connection 无法由 WillConnect 事件更改。

说明

当调用该方法时，ConnectionString、UserID、Password 和 Options 参数设置为引发该事件的操作所建立的值。

当取消该方法时，将调用 ConnectComplete，并且它的 adStatus 参数将设置为 adStatusErrorsOccurred。