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 |