Verbindung wird getrennt

Wenn eine RAS-Clientanwendung einen Verbindungsvorgang startet, empfängt der RasDial-Aufruf ein HR STRETCHNN-Verbindungshandle, um die Verbindung zu identifizieren. Wenn das zurückgegebene Handle nicht NULL ist, muss der Client schließlich die RasHangUp-Funktion aufrufen, um die Verbindung zu beenden. Wenn während des Verbindungsvorgangs ein Fehler auftritt, muss der Client RasHangUp aufrufen, obwohl die Verbindung nie hergestellt wurde.

Die Anwendung, die RasHangUp aufruft, sollte nicht sofort beendet werden, da der Remotezugriff Verbindungs-Manager Zeit zum ordnungsgemäßen Beenden der Verbindung benötigt. Stattdessen sollte die Anwendung warten, bis die RasGetConnectStatus-Funktion ERROR _ INVALID HANDLE zurückgibt, was _ angibt, dass die Verbindung gelöscht wurde.

Eine RAS-Clientanwendung muss möglicherweise eine Verbindung beenden, obwohl sie nicht über das von RasDialzurückgegebene Handle verfügt. Beispielsweise könnte die Anwendung, die RasDial aufgerufen hat, beendet worden sein, nachdem die Verbindung erfolgreich hergestellt wurde. In diesem Fall kann die Trennende Anwendung die RasEnumConnections-Funktion verwenden, um alle aktuellen Verbindungen abzurufen. Für jede Verbindung gibt RasEnumConnections eine RASCONN-Struktur zurück, die das HROANN-Verbindungshandle und den Telefonbucheintragsnamen oder die Telefonnummer enthält, die beim Starten des Verbindungsvorgangs angegeben wurde. Diese Informationen können verwendet werden, um eine Liste der Verbindungen anzuzeigen, aus denen der Benutzer die Zu beendende Verbindung auswählen kann.