Manipuladores de notificação
Uma chamada RasDial assíncrona deve especificar um manipulador de notificação. Durante uma operação de conexão assíncrona, o Gerenciador de Conexões de Acesso Remoto usa o manipulador de notificação para informar o cliente RAS sempre que o estado da conexão for alterado ou ocorrer um erro.
As ações executadas por um manipulador de notificação podem ser divididas nas seguintes categorias:
- Manipulação de erros.
- Fornecer comentários ao usuário à medida que a operação de conexão prossegue pelos vários estados de conexão. Consulte Notificações informativas.
- Manipulando estados pausados.
- Sinalizando o aplicativo cliente RAS quando a operação de conexão tiver sido concluída. Confira Notificações de Conclusão.
Há três tipos de manipuladores de notificação, cada um recebe as mesmas informações básicas: o estado de conexão atual e um código de erro diferente de zero somente se ocorrer um erro.
| Valor | Definição |
|---|---|
| RasDialFunc | Um protótipo de função de retorno de chamada que recebe apenas o estado de conexão atual e as informações de código de erro. |
| RasDialFunc1 | Um protótipo de função de retorno de chamada que recebe o identificador de conexão HRASCONN e informações de erro estendidas, além das informações básicas. O parâmetro de identificador de conexão torna RasDialFunc1 útil para aplicativos cliente que dão suporte a várias operações de conexão simultâneas. Isso permite que o cliente especifique a mesma função de retorno de chamada para todas as operações e permite que a função de retorno de chamada determine qual conexão está alterando os estados. |
| RasDialFunc2 | Uma função de retorno de chamada semelhante a RasDialFunc1. No entanto, RasDialFunc2 é aprimorado para dar suporte a conexões multilink. |
| Identificador de janela | Um identificador de janela para o qual o RAS envia WM_RASDIALEVENT mensagens que contêm o estado de conexão atual e as informações de código de erro. Use esse método se o código-fonte precisar ser compatível com o Windows de 16 bits, pois o Windows de 16 bits não dá suporte a nenhuma das funções de retorno de chamada. |
O Gerenciador de Conexões de Acesso Remoto suspende a operação de conexão até que o manipulador de notificação retorne. Por esse motivo, o manipulador deve retornar o mais rápido possível, a menos que ocorra um erro.
A função RasDial não deve ser chamada de dentro de um manipulador de notificação. As outras funções de acesso remoto ( RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString e RasHangUp) podem ser chamadas de dentro de um manipulador.