Evento WillConnect (ADO)

O evento WillConnect é chamado antes do início de uma conexão.

Aplica-se ao:objeto Connection (ADO)

Sintaxe

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

Parâmetros

ConnectionString
Um String que contém informações de conexão da conexão pendente.

UserID
Um String que contém um nome de usuário da conexão pendente.

Senha
Um String que contém uma senha da conexão pendente.

Opções
Um valor Long que indica como o provedor deve avaliar o ConnectionString. Sua única opção é adAsyncOpen.

adStatus
Um valor de status 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 o evento seja retornado, defina esse parâmetro como adStatusUnwantedEvent para evitar as notificações seguintes. Defina esse parâmetro como adStatusCancel para solicitar a operação de conexão que causou o cancelamento dessa notificação.

pConnection
O objeto Connection para o qual a notificação de eventos se aplica. As alterações nos parâmetros de Connection pelo manipulador de eventos WillConnect não terão efeito em Connection.

Comentários

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

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

Consulte Também

Exemplo do modelo de eventos ADO (VC++)
Resumo do manipulador de eventos ADO