IMsRdpClient::RequestClose-Methode
Fordert ein ordnungsgemäßes Herunterfahren des ActiveX-Remotedesktopsteuerelements an. Ein ordnungsgemäßes Herunterfahren kann das Beenden der Remotedesktopdienste-Sitzung des Benutzers umfassen, aber nicht das Herunterfahren des Remotedesktopsitzungshostservers (RD-Sitzungshost).
Syntax
HRESULT RequestClose(
[out] ControlCloseStatus *pCloseStatus
);
Parameter
-
pCloseStatus [out]
-
Wert aus der ControlCloseStatus-Enumeration , der angibt, ob die Anwendung das Steuerelement sofort schließen kann. Im Folgenden ist eine Liste der möglichen Werte aufgeführt.
-
controlCloseCanProceed (0x0000)
-
Die Containeranwendung kann das Steuerelement sofort schließen. 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
Gibt bei erfolgreicher Ausführung S_OK zurück.
Bemerkungen
Wenn der pCloseStatus-Parametergleich controlCloseWaitForEvents ist, sollte die Anwendung warten, bis eines der folgenden Ereignisse auftritt, 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-Sitzung angemeldet ist, löst das Steuerelement ein OnConfirmClose-Ereignis aus. Dieses Ereignis ermöglicht es der Anwendung, den Benutzer zu fragen, 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 es einer Containeranwendung, den Benutzer zu fragen, ob eine Verbindung geschlossen werden soll. Weitere Informationen finden Sie unter IMsTscAxEvents::OnConfirmClose.
Weitere Informationen zur Remotedesktop-Webverbindung finden Sie unter Anforderungen für die Remotedesktopwebverbindung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Typbibliothek |
|
| DLL |
|
| IID |
IID_IMsRdpClient ist definiert als 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |