Событие 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 не повлияет на подключение.

Комментарии

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

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

См. также:

Пример модели событий ADO (Visual C ++)
Общие сведения об обработчике событий ADO