Desconexão

Quando um aplicativo cliente RAS inicia uma operação de conexão, a chamada RasDial recebe um identificador de conexão HRASCONN para identificar a conexão. Se o identificador retornado não estiver NULL, o cliente deve eventualmente chamar a função RasHangUp para encerrar a conexão. Se ocorrer um erro durante a operação de conexão, o cliente deve chamar RasHangUp mesmo que a conexão nunca tenha sido estabelecida.

O aplicativo que chama RasHangUp não deve sair imediatamente porque o Gerenciador de Conexão de Acesso Remoto precisa de tempo para encerrar corretamente a conexão. Em vez disso, o aplicativo deve aguardar até que a função RasGetConnectStatus retorne ERROR_INVALID_HANDLE, indicando que a conexão foi excluída.

Um aplicativo cliente RAS pode precisar encerrar uma conexão mesmo que ele não tenha o identificador retornado pelo RasDial. Por exemplo, a aplicação que invocou RasDial pode ter saído depois de a conexão ter sido estabelecida com sucesso. Nesse caso, o aplicativo de desconexão pode usar a funçãoRasEnumConnections para obter todas as conexões atuais. Para cada conexão, RasEnumConnections retorna uma estrutura deRASCONNque contém o identificador de conexão HRASCONN e o nome de entrada do catálogo telefônico ou número de telefone especificado quando a operação de conexão foi iniciada. Essas informações podem ser usadas para exibir uma lista de conexões a partir das quais o usuário pode selecionar a conexão a ser finalizada.