共用方式為


WillConnect 事件 (ADO)

在連線開始之前,會呼叫 WillConnect 事件。

適用於:Connection 物件 (ADO)

語法

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

參數

ConnectionString
字串包含擱置連線的連接資訊。

UserID
字串包含擱置連線的使用者名稱。

密碼
字串包含擱置連線的密碼。

選項
Long 值,指出提供者應該如何評估 ConnectionString。 您的唯一選項是 adAsyncOpen

adStatus
EventStatusEnum 狀態值。

呼叫此事件時,此參數預設會設定為 adStatusOK。 如果事件無法要求解除擱置的作業,便會設定為 adStatusCantDeny

在此事件傳回之前,請將此參數設定為 adStatusUnwantedEvent 以防止後續的通知。 將此參數設定為 adStatusCancel 以要求造成取消此通知的連線作業。

pConnection
套用此事件通知的 Connection 物件。 WillConnect 事件處理常式對 Connection 參數所做的變更不會影響 Connection

備註

呼叫 WillConnect 時,ConnectionStringUserIDPasswordOptions 參數會設定為造成此事件 (擱置連線) 作業所建立的值,而且可以在事件傳回之前變更。 WillConnect 可能會傳回擱置連線取消的要求。

取消此事件時,將會呼叫 ConnectComplete,並將其 adStatus 參數設定為 adStatusErrorsOccurred

另請參閱

ADO 事件模型範例 (VC++)
ADO 事件處理常式摘要