Partager via


Déconnexion en cours

Lorsqu’une application cliente RAS démarre une opération de connexion, l’appel RasDial reçoit un handle de connexion HRASCONN pour identifier la connexion. Si le handle retourné n’est pas NULL, le client doit appeler la fonction RasHangUp pour mettre fin à la connexion. Si une erreur se produit pendant l’opération de connexion, le client doit appeler RasHangUp même si la connexion n’a jamais été établie.

L’application qui appelle RasHangUp ne doit pas se fermer immédiatement, car le Gestionnaire des connexions d’accès à distance a besoin de temps pour arrêter correctement la connexion. Au lieu de cela, l’application doit attendre que la fonction RasGetConnectStatus retourne ERROR_INVALID_HANDLE, indiquant que la connexion a été supprimée.

Une application cliente RAS peut avoir besoin de mettre fin à une connexion même si le handle n’est pas retourné par RasDial. Par exemple, l’application qui a appelé RasDial peut s’être arrêtée après l’établissement de la connexion. Dans ce cas, l’application de déconnexion peut utiliser la fonction RasEnumConnections pour obtenir toutes les connexions actuelles. Pour chaque connexion, RasEnumConnections retourne une structure RASCONN qui contient le handle de connexion HRASCONN et le nom ou le numéro de téléphone d’entrée du carnet de téléphone spécifiés lors du démarrage de l’opération de connexion. Ces informations peuvent être utilisées pour afficher une liste de connexions à partir desquelles l’utilisateur peut sélectionner la connexion à terminer.