WillConnect (ConnectionEvent) Method

WillConnect (ConnectionEvent) Method

   

該方法在連接啟動(dòng)前調(diào)用。在掛起連接中使用的參數(shù)將作為輸入?yún)?shù)提供，并可在方法返回之前進(jìn)行更改。該方法可以返回取消掛起連接的請(qǐng)求。

語(yǔ)法

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

參數(shù)

ConnectionString   字符串，包含有關(guān)掛起連接的連接信息。

UserID   字符串，包含掛起連接的用戶(hù)名。

Password   字符串，包含掛起連接的密碼。

Options   長(zhǎng)整型值，指明提供者應(yīng)如何計(jì)算 ConnectionString。只能選擇 adAsyncOpen。

adStatus   EventStatusEnum 狀態(tài)值。

當(dāng)調(diào)用該方法時(shí)，如果引發(fā)事件的操作成功，則該參數(shù)設(shè)置為 adStatusOK。如果該方法無(wú)法請(qǐng)求取消掛起的操作，那么該參數(shù)設(shè)置為 adStatusCantDeny。

在該方法返回前，將該參數(shù)設(shè)置為 adStatusUnwantedEvent 以避免后續(xù)的通知。將該參數(shù)設(shè)置為 adStatusCancel 以請(qǐng)求引起取消該通知的連接操作。

pConnection   該事件通知所針對(duì)的 Connection 對(duì)象。該 Connection 無(wú)法由 WillConnect 事件更改。

說(shuō)明

當(dāng)調(diào)用該方法時(shí)，ConnectionString、UserID、Password 和 Options 參數(shù)設(shè)置為引發(fā)該事件的操作所建立的值。

當(dāng)取消該方法時(shí)，將調(diào)用 ConnectComplete，并且它的 adStatus 參數(shù)將設(shè)置為 adStatusErrorsOccurred。