Função RasHangUpA (ras.h)

A função RasHangUp encerra uma conexão de acesso remoto. A conexão é especificada com um identificador de conexão RAS. A função libera todos os recursos RASAPI32.DLL associados ao identificador.

Sintaxe

DWORD RasHangUpA(
  [in] HRASCONN unnamedParam1
);

Parâmetros

[in] unnamedParam1

Especifica a conexão de acesso remoto a ser encerrada. Esse é um identificador retornado de uma chamada anterior para rasDial ou RasEnumConnections.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro ou um valor de códigos de erro de roteamento e acesso remoto ou Winerror.h.

Valor	Significado
ERROR_INVALID_HANDLE	O identificador especificado em hrasconn é inválido.

Observações

A conexão será encerrada mesmo que a chamada de RasDial ainda não tenha sido concluída.

Após essa chamada, o identificador de hrasconn não pode mais ser usado.

Um aplicativo não deve chamar rashangup e sair imediatamente. O computador de estado de conexão precisa de tempo para terminar corretamente. Se o sistema encerrar prematuramente o computador de estado, o computador de estado poderá falhar ao fechar corretamente uma porta, deixando a porta em um estado inconsistente. Além disso, uma tentativa imediata de usar a mesma conexão pode falhar deixando a conexão inutilizável. Uma maneira simples de evitar esses problemas é chamar de Suspensão (3000) depois de retornar de RasHangUp; depois dessa pausa, o aplicativo pode sair. Uma maneira mais responsiva de evitar esses problemas é, depois de retornar de RasHangUp, chamar RasGetConnectStatus(hrasconn) e de Suspensão (0) em um loop até RasGetConnectStatus retornar ERROR_INVALID_HANDLE.

Você pode chamar RasHangUp no identificador retornado pelo rasGetSubEntryHandle para encerrar um único link em uma conexão de vários vínculos. No entanto, nesse caso, você não pode usar rasGetConnectStatus para determinar se o link foi encerrado; rasGetConnectStatus pode não retornar ERROR_INVALID_HANDLE mesmo que o link tenha sido encerrado com êxito.

Nota

O cabeçalho ras.h define RasHangUp como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ras.h
biblioteca	Rasapi32.lib
de DLL	Rasapi32.dll

Consulte também

RASCONN

RasCustomHangUp

RasDial

RasEnumConnections

rasGetConnectStatus

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

Funções do Serviço de Acesso Remoto

de suspensão