WillConnect イベント (ADO)

WillConnect イベントは、接続が開始される前に呼び出されます。

適用対象:Connection オブジェクト (ADO)

構文

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

パラメーター

ConnectionString の
保留中の接続の接続情報を含む 文字列。

UserID の
保留中の接続のユーザー名を含む 文字列。

パスワードの
保留中の接続のパスワードを含む 文字列。

オプションの
プロバイダーが ConnectionStringを評価する方法を示す Long 値です。 唯一のオプションは adAsyncOpen です。

adStatus を する
EventStatusEnum 状態値。

このイベントが呼び出されると、このパラメーターは既定で adStatusOK に設定されます。 イベントが保留中の操作の取り消しを要求できない場合は、adStatusCantDeny を するように設定されます。

このイベントが返される前に、このパラメーターを adStatusUnwantedEvent に設定して、後続の通知を防ぎます。 このパラメーターを adStatusCancel 設定して、この通知の取り消しの原因となった接続操作を要求します。

pConnection を する
このイベント通知が適用される Connection オブジェクト。 WillConnect イベント ハンドラーによって 接続 のパラメーターを変更しても、接続には影響しません。

備考

WillConnect 呼び出されると、ConnectionString、UserID、Password、および Options パラメーターは、このイベントの原因となった操作によって確立された値 (保留中の接続) に設定され、イベントが戻る前に変更できます。 WillConnect は、保留中の接続を取り消す要求を返す場合があります。

このイベントが取り消されると、connectComplete は、adStatus パラメーターadStatusErrorsOccurredに設定して呼び出されます。

関連項目

ADO イベント モデルの例 (VC++)
ADO イベント ハンドラーの概要