Disconnessione

Quando un'applicazione client RAS avvia un'operazione di connessione, la chiamataRasDialriceve un handle di connessione HRASCONN per identificare la connessione. Se l'handle restituito non è NULL, il client deve infine chiamare la funzione RasHangUp per terminare la connessione. Se si verifica un errore durante l'operazione di connessione, il client deve chiamare RasHangUp anche se la connessione non è mai stata stabilita.

L'applicazione che chiama RasHangUp non deve uscire immediatamente perché il Gestore connessione di accesso remoto richiede tempo per chiudere correttamente la connessione. L'applicazione deve invece attendere fino a quando la funzione RasGetConnectStatus restituisce ERROR_INVALID_HANDLE, a indicare che la connessione è stata eliminata.

Un'applicazione client RAS potrebbe dover terminare una connessione anche se non dispone dell'handle restituito da RasDial. Ad esempio, l'applicazione che ha chiamato RasDial potrebbe essere stata chiusa dopo che la connessione è stata stabilita con successo. In questo caso, l'applicazione di disconnessione può usare la funzioneRasEnumConnections per ottenere tutte le connessioni correnti. Per ogni connessione, RasEnumConnections restituisce una struttura RASCONN che contiene l'handle di connessione HRASCONN e il nome della voce della rubrica o il numero di telefono specificato all'avvio dell'operazione di connessione. Queste informazioni possono essere utilizzate per visualizzare un elenco di connessioni da cui l'utente può selezionare la connessione da terminare.