Событие WillConnect (ADO)

Область применения: Access 2013, Office 2013

Событие WillConnect вызывается перед началом подключения.

Синтаксис

WillConnectConnectionString, UserID, Password, Options, adStatus, pConnection

Параметры

Параметр	Описание
ConnectionString	Строка, содержащая сведения о подключении для ожидающего подключения.
UserID	Строка, содержащая имя пользователя для ожидающего подключения.
Password	Строка, содержащая пароль для ожидающего подключения.
Параметры	Значение Long , указывающее, как поставщик должен оценивать ConnectionString. Единственный вариант — adAsyncOpen.
adStatus	EventStatusEnum. При вызове этого события этот параметр по умолчанию имеет значение adStatusOK . Для параметра задано значение adStatusCantDeny , если событие не может запросить отмену ожидающей операции. Перед возвратом этого события задайте для этого параметра значение adStatusUnwantedEvent , чтобы предотвратить последующие уведомления. Задайте для этого параметра значение adStatusCancel , чтобы запросить операцию подключения, которая вызвала отмену этого уведомления.
pConnection	Объект Connection , к которому применяется это уведомление о событии. Изменения параметров подключения обработчиком событий WillConnect не повлияет на соединение.

Замечания

При вызове WillConnect параметры ConnectionString, UserID, Password и Options задаются значениями, установленными операцией, вызвавшей это событие (ожидающее подключение), и могут быть изменены до возврата события. Функция WillConnect может вернуть запрос на отмену ожидающего подключения.

При отмене этого события будет вызываться ConnectComplete с параметром adStatus , равным adStatusErrorsOccurred.