IMsRdpClient::RequestClose-Methode
Fordert ein ordnungsgemäßes Herunterfahren des Remotedesktop ActiveX an. Ein ordnungsgemäßes Herunterfahren kann das Beenden der Remotedesktopdienste-Sitzung des Benutzers umfassen, aber es wird der Remotedesktop-Sitzungshost(RD-Sitzungshost)-Server nicht heruntergefahren.
Syntax
HRESULT RequestClose(
[out] ControlCloseStatus *pCloseStatus
);
Parameter
-
pCloseStatus [ out]
-
Ein Wert aus der ControlCloseStatus-Enumeration, der angibt, ob die Anwendung das Steuerelement sofort schließen kann. Im Folgenden finden Sie eine Liste der möglichen Werte.
-
controlCloseCanProceed (0x0000)
-
Die Containeranwendung kann mit dem sofortigen Schließen des Steuerelements fortfahren. Dieser Wert kann auch angeben, dass die Verbindung bereits beendet wurde.
-
controlCloseWaitForEvents (0x0001)
-
Die Containeranwendung sollte das Steuerelement nicht sofort schließen. Die Anwendung sollte warten, bis eines der im folgenden Abschnitt "Hinweise" beschriebenen Ereignisse auftritt, bevor sie geschlossen wird.
Rückgabewert
Geben Sie S _ OK zurück, wenn erfolgreich.
Hinweise
Wenn der pCloseStatus-Parameter gleich controlCloseWaitForEvents ist, sollte die Anwendung warten, bis eines der folgenden Ereignisse eintritt, bevor die Anwendung das Steuerelement schließt:
- IMsTscAxEvents::OnDisconnected. Wenn der Benutzer nicht bei der Remotedesktopdienste-Sitzung angemeldet ist, kann die Anwendung die DestroyWindow-Funktion aufrufen, um alle Fenster zu zerstören und dann das Steuerelement zu schließen.
- IMsTscAxEvents::OnConfirmClose. Wenn der Benutzer bei der Remotedesktopdienste ist, wird vom Steuerelement ein OnConfirmClose-Ereignis angezeigt. Mit diesem Ereignis kann die Anwendung den Benutzer dazu auffordern, ob die Verbindung geschlossen werden soll. Wenn der Benutzer auf die Eingabeaufforderung mit Ja antwortet, kann die Containeranwendung DestroyWindow aufrufen, um alle Fenster zu zerstören und das Steuerelement zu schließen.
RequestClose ermöglicht einer Containeranwendung, den Benutzer zu fragen, ob eine Verbindung geschlossen werden soll. Weitere Informationen finden Sie unter IMsTscAxEvents::OnConfirmClose.
Weitere Informationen zu Remotedesktop-Webverbindung finden Sie unter Anforderungen für Remotedesktop-Webverbindung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ IMsRdpClient ist als 92b4a539-7115-4b7c-a5a9-e5d9efc2780a definiert. |