WillConnect イベント (ADO)

  • [アーティクル]

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

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

構文

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

パラメーター

ConnectionString
保留中の接続の接続情報を含む String。

UserID
保留中の接続のユーザー名を含む String。

パスワード
保留中の接続のパスワードを含む String。

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

adStatus
EventStatusEnum の状態値。

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

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

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

注釈

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

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

参照

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