Compartilhar via


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

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

Confira também

RASCONNSTATE

Rasdial

RasDialFunc

RasDialFunc1

Rasenumconnections

Rasenumentries

Rasgetconnectstatus

RasGetErrorString

Rashangup

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

Funções do serviço de acesso remoto