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

Artigo
03/01/2024

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