Função de retorno de chamada RASDIALFUNC (ras.h)

Artigo
03/13/2024

A função de retorno de chamada RasDialFunc é chamada pela função RasDial quando ocorre uma alteração de estado durante um processo de conexão RAS.

Sintaxe

RASDIALFUNC Rasdialfunc;

void Rasdialfunc(
  UINT unnamedParam1,
  tagRASCONNSTATE unnamedParam2,
  DWORD unnamedParam3
)
{...}

Parâmetros

unnamedParam1

unnamedParam2

unnamedParam3

Valor retornado

Nenhum

Comentários

Uma operação de conexão RasDial é suspensa durante uma chamada para uma função de retorno de chamada RasDialFunc . Por esse motivo, a implementação de RasDialFunc geralmente deve retornar 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 RasDialFunc geralmente não é um problema. O requisito de retorno de prompt também não se aplica quando dwError é diferente de 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 rasDialFunc não deve depender da ordem ou ocorrência de estados de conexão RASCONNSTATE específicos, pois isso pode variar entre plataformas.

Não chame a função RasDial de dentro de uma função de retorno de chamada RasDialFunc . 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.

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

ObservaçãoRasDialFunc é um espaço reservado para o nome da função definida pelo aplicativo ou 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