適用先: Access 2013、Office 2013
WillConnect イベントは、接続が開始される前に呼び出されます。
構文
WillConnectConnectionString、 UserID、 パスワード、 オプション、 adStatus、 pConnection
パラメーター
| パラメーター | 説明 |
|---|---|
| ConnectionString | 保留中の接続の接続情報が格納された文字列型 ( String ) の値です。 |
| UserID | 保留中の接続のユーザー名が格納された文字列型 ( String ) の値です。 |
| Password | 保留中の接続のパスワードが格納された文字列型 ( String ) の値です。 |
| Options | プロバイダーが ConnectionString を評価する方法を示す長整数型 (Long) の値です。 オプションは adAsyncOpen のみ指定できます。 |
| adStatus |
EventStatusEnum。 このイベントが呼び出されたとき、既定では、このパラメーターは adStatusOK に設定されます。 保留中の操作の取り消しをイベントが要求できない場合、このパラメーターは adStatusCantDeny に設定されます。 このイベントから制御が戻る前に後続の通知が行われるのを防ぐには、このパラメーターを adStatusUnwantedEvent に設定します。 この通知の取り消しを実行する接続操作を要求するには、このパラメーターを adStatusCancel に設定します。 |
| pConnection | このイベント通知が適用される Connection オブジェクト。 WillConnect イベント ハンドラーで Connection のパラメーターが変更されても、Connection には影響はありません。 |
注釈
WillConnect を呼び出したとき、ConnectionString、UserID、Password、および Options の各パラメーターの値は、このイベント (保留中の接続) を発生させた操作によって設定され、イベントから制御が戻る前に変更できます。 WillConnect では、保留中の接続を取り消す要求を返す場合もあります。
このイベントが取り消されると、adStatus パラメーターが adStatusErrorsOccurred に設定され ConnectComplete が呼び出されます。