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	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClient ist definiert als 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Siehe auch

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

IMsTscAxEvents::OnConfirmClose

IMsTscAxEvents::OnDisconnected