Evento WillConnect (ADO)

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

Aplica-se aoobjeto:Connection (ADO)

Sintaxe

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

Parâmetros

ConnectionString
Uma cadeia de caracteres que contém informações de conexão para a conexão pendente.

UserID
Uma cadeia de caracteres que contém um nome de usuário para a conexão pendente.

Senha
Uma cadeia de caracteres que contém uma senha para a 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 esse evento retorne, defina esse parâmetro como adStatusUnwantedEvent para evitar notificações subsequentes. 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 essa notificação de evento se aplica. As alterações nos parâmetros da Conexão pelo manipulador de eventos WillConnect não terão efeito na Conexão.

Observações

Quando WillConnect é chamado, os parâmetros ConnectionString, UserID, Password e Options são definidos para os valores estabelecidos pela operação que causou esse evento (a conexão pendente) e podem ser alterados antes que o evento retorne. 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.

Consulte Também

exemplo de modelo de eventos do ADO (VC++)
resumo do manipulador de eventos do ADO