Событие WillConnect (ADO)

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

Область применения: объект подключения (ADO)

Синтаксис

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

Параметры

ConnectionString
Строка, содержащая сведения о подключении для ожидающего подключения.

UserID
Строка, содержащая имя пользователя для ожидающего подключения.

Пароль
Строка, содержащая пароль для ожидающего подключения.

Параметры
Длинное значение, указывающее, как поставщик должен оценивать ConnectionString. Единственным вариантом является adAsyncOpen.

adStatus
Значение состояния EventStatusEnum.

При вызове этого события этот параметр по умолчанию имеет значение adStatusOK . Значение adStatusCantDeny имеет значение adStatusCantDeny , если событие не может запросить отмену ожидающей операции.

Перед возвратом этого события задайте для этого параметра значение adStatusUnwantedEvent , чтобы предотвратить последующие уведомления. Задайте этому параметру adStatusCancel запрос операции подключения, вызвавшей отмену этого уведомления.

pConnection
Объект Connection, для которого применяется это уведомление о событии. Изменения параметров подключения обработчиком событий WillConnect не влияют на подключение.

Замечания

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

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

См. также

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