Compartilhar via


função de retorno de chamada RASDIALFUNC1 (ras.h)

Uma função RasDialFunc1 é chamada pela função RasDial quando ocorre uma alteração de estado durante um processo de conexão de acesso remoto. Uma função RasDialFunc1 é comparável a uma função RasDialFunc , mas é aprimorada pela adição de dois parâmetros: um identificador para a conexão RAS e um código de erro estendido.

Sintaxe

RASDIALFUNC1 Rasdialfunc1;

void Rasdialfunc1(
  HRASCONN unnamedParam1,
  UINT unnamedParam2,
  tagRASCONNSTATE unnamedParam3,
  DWORD unnamedParam4,
  DWORD unnamedParam5
)
{...}

Parâmetros

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

Valor retornado

Nenhum

Comentários

Uma operação de conexão RasDial é suspensa durante uma chamada para uma função de retorno de chamada RasDialFunc1 . Por esse motivo, a implementação rasDialFunc1 geralmente retorna o mais rápido possível. Há duas exceções a essa regra. Dispositivos assíncronos (lentos), como modems, geralmente têm períodos de tempo limite medidos em segundos em vez de milissegundos; um retorno lento de uma função RasDialFunc1 geralmente não é um problema. O requisito de retorno de prompt também não se aplica quando dwError não é zero, indicando que ocorreu um erro. É seguro, por exemplo, colocar uma caixa de diálogo de erro e aguardar a entrada do usuário.

A implementação rasDialFunc1 não deve depender da ordem ou da ocorrência de determinados estados de conexão RASCONNSTATE , pois isso pode variar entre plataformas.

Não chame a função RasDial de dentro de uma função de retorno de chamada RasDialFunc1 . Chame as funções RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString e RasHangUp de dentro da função de retorno de chamada. Por exemplo, chamar RasGetConnectStatus de dentro de uma função de retorno de chamada seria útil para determinar o nome e o tipo do dispositivo de conexão.

Observe que, para conveniência, RasHangUp pode ser chamado de dentro de uma função de retorno de chamada RasDialFunc1 . No entanto, grande parte do processamento de travamento ocorre depois que a função de retorno de chamada RasDialFunc1 é retornada.

RasDialFunc1 é um espaço reservado para o nome da função definida pelo aplicativo ou definida pela biblioteca.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ras.h

Confira também

RASCONNSTATE

Rasdial

RasDialFunc

RasDialFunc2

Rasenumconnections

Rasenumentries

Rasgetconnectstatus

RasGetErrorString

Rashangup

Visão geral do RAS (Serviço de Acesso Remoto)

Funções do serviço de acesso remoto