Evento WillConnect (ADO)

Aplica-se ao: Access 2013, Office 2013

O evento WillConnect é chamado antes que uma conexão seja iniciada.

Sintaxe

WillConnectConnectionString, UserID, Password, Options, adStatus, pConnection

Parâmetros

Parâmetro	Descrição
ConnectionString	Uma String que contém informações de conexão para a conexão pendente.
UserID	Um String que contém um nome de usuário para a conexão pendente.
Password	Uma String que contém uma senha para a conexão pendente.
Options	Um valor Long que indica como o provedor deve avaliar o ConnectionString. Sua única opção é adAsyncOpen.
adStatus	EventStatusEnum. Quando esse evento é chamado, esse parâmetro é definido como adStatusOK, por padrão. Ele será definido como adStatusCantDeny se o evento não puder solicitar o cancelamento da operação pendente. Antes que esse evento seja retornado, defina esse parâmetro como adStatusUnwantedEvent para impedir notificações subsequentes. Defina esse parâmetro como adStatusCancel para solicitar uma operação de conexão que provocou o cancelamento dessa notificação.
pConnection	O objeto Connection ao qual essa notificação de evento se aplica. As alterações aos parâmetros de Connection pela manipulador de eventos WillConnect não terão efeito no Connection.

Comentários

Quando o WillConnect é chamado, os parâmetros ConnectionString, UserID, Password e Options são definidos como os valores estabelecidos pela operação que provocou esse evento (a conexão pendente) e podem ser alterados antes que o evento seja retornado. O WillConnect pode retornar uma solicitação para que a conexão pendente seja cancelada.

Quando esse evento for cancelado, ConnectComplete será chamado com seu parâmetro adStatus definido como adStatusErrorsOccurred.