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

Artigo
08/25/2023

Uma função de retorno de chamada RasDialFunc2 é chamada pelas chamadas de função RasDial quando ocorre uma alteração de estado durante um processo de conexão de acesso remoto. Uma função RasDialFunc2 é semelhante à função de retorno de chamada RasDialFunc1 , exceto pelo fato de fornecer informações adicionais para conexões multilink.

Sintaxe

RASDIALFUNC2 Rasdialfunc2;

DWORD Rasdialfunc2(
  ULONG_PTR unnamedParam1,
  DWORD unnamedParam2,
  HRASCONN unnamedParam3,
  UINT unnamedParam4,
  tagRASCONNSTATE unnamedParam5,
  DWORD unnamedParam6,
  DWORD unnamedParam7
)
{...}

Parâmetros

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

unnamedParam6

unnamedParam7

Valor retornado

Se a função RasDialFunc2 retornar um valor diferente de zero, RasDial continuará a enviar notificações de retorno de chamada.

Se a função RasDialFunc2 retornar zero, RasDial interromperá o envio de notificações de retorno de chamada para todas as subentidades.

Comentários

Uma operação de conexão RasDial é suspensa durante uma chamada para uma função de retorno de chamada RasDialFunc2 . Por esse motivo, a implementação de RasDialFunc2 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 RasDialFunc2 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 rasDialFunc2 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 RasDialFunc2 . 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 RasDialFunc2 . No entanto, grande parte do processamento de travamento ocorre depois que a função de retorno de chamada RasDialFunc2 é retornada.

ObservaçãoRasDialFunc2 é 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