Kopplar ifrån

När ett RAS-klientprogram påbörjar en anslutningsoperation, tar RasDial--anropet emot ett HRASCONN- anslutningshandtag för att identifiera anslutningen. Om det returnerade handtaget inte är NULLmåste klienten anropa funktionen RasHangUp för att avsluta anslutningen. Om ett fel uppstår under anslutningsåtgärden måste klienten anropa RasHangUp även om anslutningen aldrig upprättades.

Programmet som anropar RasHangUp bör inte avslutas omedelbart eftersom anslutningshanteraren för fjärråtkomst behöver tid för att avsluta anslutningen korrekt. I stället bör programmet vänta tills funktionen RasGetConnectStatus returnerar ERROR_INVALID_HANDLE, vilket anger att anslutningen har tagits bort.

Ett RAS-klientprogram kan behöva avsluta en anslutning även om det inte har handtaget som returneras av RasDial. Till exempel kan programmet som anropade RasDial ha avslutats efter att anslutningen framgångsrikt har upprättats. I det här fallet kan frånkopplingsprogrammet använda funktionen RasEnumConnections för att hämta alla aktuella anslutningar. För varje anslutning returnerar RasEnumConnections en RASCONN- struktur som innehåller HRASCONN- anslutningshandtag och telefonbokspostnamnet eller telefonnumret som angavs när anslutningsåtgärden startades. Den här informationen kan användas för att visa en lista över anslutningar från vilka användaren kan välja anslutningen till slutet.