IMsTscAxEvents-Schnittstelle
Enthält Methoden, die Informationen vom Server empfangen, die sich auf Clientsteuerelementereignisse beziehen. Zu den Ereignissen gehören Das Herstellen einer Verbindung und Trennung, Anforderungen im Vollbildmodus, erfolgreiche Anmeldung und Fehlerbedingungen.
Members
Die IMsTscAxEvents-Schnittstelle erbt von der IDispatch-Schnittstelle . IMsTscAxEvents verfügt auch über folgende Arten von Membern:
Methoden
Die IMsTscAxEvents-Schnittstelle verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| OnAuthenticationWarningDismissed | Nach einem ActiveX-Steuerelement aufgerufen, wird ein Authentifizierungsdialogfeld angezeigt (z. B. das Dialogfeld Zertifikatfehler). |
| OnAuthenticationWarningDisplayed | Wird vor einem ActiveX-Steuerelement aufgerufen, wird ein Authentifizierungsdialogfeld angezeigt (z. B. das Dialogfeld Zertifikatfehler). |
| OnAutoReconnected | Wird aufgerufen, wenn das Clientsteuerelement automatisch wieder eine Verbindung mit einer Remotesitzung hergestellt hat. |
| OnAutoReconnecting | Wird aufgerufen, wenn ein Client gerade dabei ist, eine Sitzung automatisch wieder mit einem RD-Sitzungshostserver zu verbinden. |
| OnAutoReconnecting2 | Wird aufgerufen, wenn ein Client gerade dabei ist, eine Sitzung automatisch wieder mit einem RD-Sitzungshostserver zu verbinden. |
| OnChannelReceivedData | Wird aufgerufen, wenn der Client Daten in einem skriptfähigen virtuellen Kanal empfängt. |
| OnConfirmClose | Wird aufgerufen, wenn der Client die IMsRdpClient::RequestClose-Methode aufruft. |
| OnConnected | Wird aufgerufen, wenn das Clientsteuerelement gerade eine Verbindung mit einem RD-Sitzungshostserver herstellt. |
| OnConnecting | Wird aufgerufen, wenn das Clientsteuerelement als Reaktion auf einen Aufruf von IMsTscAx::Connect eine Verbindung mit einem Server herstellt. |
| OnConnectionBarPullDown | Wird aufgerufen, wenn der Benutzer auf die Verbindungsleiste gezogen wurde. |
| OnDevicesButtonPressed | Wird aufgerufen, wenn die Schaltfläche Geräte in der Verbindungsleiste gedrückt wurde. |
| OnDisconnected | Wird aufgerufen, wenn das Clientsteuerelement vom RD-Sitzungshostserver getrennt wurde. |
| OnEnterFullScreenMode | Wird aufgerufen, wenn der Client in den Vollbildmodus wechselt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination für den Vollbildmodus (STRG+ALT+BREAK) drückt. |
| OnFatalError | Wird aufgerufen, wenn beim Clientsteuerelement ein schwerwiegender Fehler auftritt. |
| OnFocusReleased | Wird aufgerufen, wenn die Tastenkombination des Freigabefokus gedrückt wird. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer STRG+ALT+NACH-LINKS oder die Tastenkombination STRG+ALT+NACH-RECHTS-TASTE drückt. |
| OnIdleTimeoutNotification | Wird aufgerufen, wenn der Benutzer während des von der IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout-Methode festgelegten Zeitraums keine Maus- oder Tastatureingaben vorgenommen hat. |
| OnLeaveFullScreenMode | Wird aufgerufen, wenn der Client den Vollbildmodus verlässt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination für den Vollbildmodus (STRG+ALT+BREAK) drückt. |
| OnLoginComplete | Wird aufgerufen, wenn sich das Clientsteuerelement erfolgreich bei einem RD-Sitzungshostserver angemeldet hat, und folgt der Anzeige des Dialogfelds Windows-Anmeldung. |
| OnLogonError | Wird aufgerufen, wenn ein Anmeldefehler oder ein anderes Anmeldeereignis auftritt. |
| OnMouseInputModeChanged | Wird aufgerufen, wenn sich der Mauseingabemodus geändert hat. |
| OnNetworkStatusChanged | Wird aufgerufen, wenn sich das Netzwerk status geändert hat. |
| OnReceivedTSPublicKey | Wird während der Verbindungssequenz aufgerufen, wenn der Client den öffentlichen Schlüssel vom Server abruft. Dieses Ereignis wird nur aufgerufen, wenn die NotifyTSPublicKey-EigenschaftVARIANT_TRUE ist. |
| OnRemoteDesktopSizeChange | Wird aufgerufen, um anzugeben, dass sich die Größe des Clientsteuerelements auf dem Remotedesktop als Reaktion auf einen Clientsteuerungsvorgang geändert hat. |
| OnRemoteProgramDisplayed | Wird aufgerufen, wenn ein RemoteApp-Programm angezeigt wird. |
| OnRemoteProgramResult | Wird aufgerufen, wenn ein RemoteApp-Programm ein Ergebnis an das Clientsteuerelement zurückgibt. |
| OnRemoteWindowDisplayed | Wird aufgerufen, wenn ein RemoteApp-Fenster angezeigt wird. |
| OnRequestContainerMinimize | Wird aufgerufen, wenn der Benutzer die Schaltfläche Minimieren auf der Verbindungsleiste im Vollbildmodus drückt. Das Auslösen dieses Ereignisses ist eine Anforderung, die die Containeranwendung selbst minimiert. |
| OnRequestGoFullScreen | Wird aufgerufen, wenn der Client anfordert, in den Vollbildmodus zu wechseln, und die IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen-Methode aufgerufen wird, um die ContainerHandledFullScreen-Eigenschaft auf einen nichtzero-Wert festzulegen. |
| OnRequestLeaveFullScreen | Wird aufgerufen, wenn der Client anfordert, den Vollbildmodus zu verlassen, und die IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen-Eigenschaft auf einen nichtzero-Wert festgelegt wurde. |
| OnServiceMessageReceived | Wird aufgerufen, wenn der Client eine Systemmeldung empfängt. |
| OnUserNameAcquired | Wird aufgerufen, wenn der Benutzername vom Steuerelement abgerufen wurde. |
| OnWarning | Wird aufgerufen, wenn beim Clientsteuerelement eine Fehlerbedingung auftritt, die nicht fatal ist. |
Bemerkungen
Weitere Informationen zur Remotedesktop-Webverbindung finden Sie unter Anforderungen für die Remotedesktopwebverbindung.
Die RDP-Clientsteuerungsobjekte (MsRdpClient, MsRdpClientNonScriptable und ihre Ableitungen) sind miteinander verbundene Objekte. Um Ereignisse vom ActiveX-Remotedesktop-Steuerelement zur Remotesitzung zu empfangen, kann eine Anwendung IMstscAxEvents implementieren und die folgenden Schritte ausführen.
- Rufen Sie IUnknown::QueryInterface im RDP-Clientsteuerungsobjekt auf, um einen Zeiger auf die IConnectionPointContainer-Schnittstelle abzurufen.
- Rufen Sie IConnectionPointContainer::FindConnectionPoint auf, und geben Sie
__uuidof(IMsTscAxEvents)als riid-Parameter an, um einen Zeiger auf die IConnectionPoint-Schnittstelle der Clientsteuerelementereignisse abzurufen. - Rufen Sie IConnectionPoint::Advise auf, um die eigene Implementierung von IMsTscAxEvents für die aufrufende Anwendung anzugeben, in der die Ereignisse verteilt werden sollen.
Die Anwendung kann bei der Implementierung von IDispatch::Invoke die folgenden DISPIDs verwenden.
| dispIdMember | Senden an Methode |
|---|---|
| DISPID_CONNECTING = 1 | OnConnecting |
| DISPID_CONNECTED = 2 | OnConnected |
| DISPID_LOGINCOMPLETE = 3 | OnLoginComplete |
| DISPID_DISCONNECTED = 4 | OnDisconnected |
| DISPID_ENTERFULLSCREENMODE = 5 | OnEnterFullScreenMode |
| DISPID_LEAVEFULLSCREENMODE = 6 | OnLeaveFullScreenMode |
| DISPID_CHANNELRECEIVEDDATA = 7 | OnChannelReceivedData |
| DISPID_REQUESTGOFULLSCREEN = 8 | OnRequestGoFullScreen |
| DISPID_REQUESTLEAVEFULLSCREEN = 9 | OnRequestLeaveFullScreen |
| DISPID_FATALERROR = 10 | OnFatalError |
| DISPID_WARNING = 11 | OnWarning |
| DISPID_REMOTEDESKTOPSIZECHANGE = 12 | OnRemoteDesktopSizeChange |
| DISPID_IDLETIMEOUTNOTIFICATION = 13 | OnIdleTimeoutNotification |
| DISPID_REQUESTCONTAINERMINIMIZE = 14 | OnRequestContainerMinimize |
| DISPID_CONFIRMCLOSE = 15 | OnConfirmClose |
| DISPID_RECEIVEDTSPUBLICKEY = 16 | OnReceivedTSPublicKey |
| DISPID_AUTORECONNECTING = 17 | OnAutoReconnecting |
| DISPID_INTERNALDIALOGDISPLAYED = 18 | OnAuthenticationWarningDisplayed |
| DISPID_INTERNALDIALOGDISMISSED = 19 | OnAuthenticationWarningDismissed |
| DISPID_ONREMOTEPROGRAMRESULT = 20 | OnRemoteProgramResult |
| DISPID_ONREMOTEPROGRAMDISPLAYED = 21 | OnRemoteProgramDisplayed |
| DISPID_LOGONERROR = 22 | OnLogonError |
| DISPID_FOCUSRELEASED = 23 | OnFocusReleased |
| DISPID_USERNAMEACQUIRED = 24 | OnUserNameAcquired |
| DISPID_MOUSEINPUTMODECHANGED = 26 | OnMouseInputModeChanged |
| DISPID_ONSTATUSINFO = 27 | Keine. Stellt der Anwendung einen VT_UI4 status Code bereit. Die Anwendung kann den in 'pDispParams-rgvarg>[0].ulVal'' enthaltenen status Code an IMsRdpClient7::GetStatusText übergeben, um den zugeordneten status Text abzurufen. |
| DISPID_SERVICEMESSAGERECEIVED = 28 | OnServiceMessageReceived |
| DISPID_ONREMOTEWINDOWDISPLAYED = 29 | OnRemoteWindowDisplayed |
| DISPID_CONNECTIONBARPULLDOWN = 30 | OnConnectionBarPullDown |
| DISPID_ONNETWORKSTATUSCHANGED = 32 | OnNetworkStatusChanged |
| DISPID_AUTORECONNECTED = 33 | OnAutoReconnected |
| DISPID_AUTORECONNECTING2 = 34 | OnAutoReconnecting2 |
| DISPID_CONNECTIONBARDEVICES = 35 | OnDevicesButtonPressed |
| DISPID_HVSINOTIFICATION = 36 | Keine. Stellt einen VT_UI4 Ereigniscode bereit. Dieses Ereignis wird in Microsoft Defender Application Guard Szenarien ausgegeben. Es sollte nicht während des normalen Betriebs ausgegeben werden. |
| DISPID_ONWOKEUPANDRECONNECTING = 37 | Keine. Dieses Ereignis wird vom ActiveX-Remotedesktop-Steuerelement nicht mehr ausgegeben. |
| DISPID_ONLOCATIONREDIRECTIONENABLEDRECEIVED = 39 | Keine. Dieses Ereignis benachrichtigt die Anwendung, dass sie mit der Verwendung von IMsRdpClientNonScriptable6::SendLocation2D oder IMsRdpClientNonScriptable6::SendLocation3D auf dem Server beginnen kann, damit der geografische Standort des Clients in der Remotesitzung widergespiegelt werden kann. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient ist definiert als 791fa017-2de3-492e-acc5-53c67a2b94d0 CLSID_MsRdpClient10 ist definiert als C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting ist definiert als A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient2 ist definiert als 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A CLSID_MsRdpClient2a ist definiert als 971127BB-259F-48C2-BD75-5F97A3331551 CLSID_MsRdpClient2NotSafeForScripting ist definiert als 3523C2FB-4031-44E4-9A3B-F1E94986EE7F CLSID_MsRdpClient3 ist definiert als 7584C670-2274-4EFB-B00B-D6AABA6D3850 CLSID_MsRdpClient3a ist definiert als 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 CLSID_MsRdpClient3NotSafeForScripting ist definiert als ACE575FD-1FCF-4074-9401-EBAB990FA9DE CLSID_MsRdpClient4 ist definiert als 4EDCB26C-D24C-4E72-AF07-B576699AC0DE CLSID_MsRdpClient4a ist definiert als 54CE37E0-9834-41AE-9896-4DAB69DC022B CLSID_MsRdpClient4NotSafeForScripting ist definiert als 6AE29350-321B-42BE-BBE5-12FB5270C0DE CLSID_MsRdpClient5 ist definiert als 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 CLSID_MsRdpClient5NotSafeForScripting ist definiert als 4EB2F086-C818-447E-B32C-C51CE2B30D31 CLSID_MsRdpClient6 ist definiert als 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 CLSID_MsRdpClient6NotSafeForScripting ist definiert als D2EA46A7-C2BF-426B-AF24-E19C44456399 CLSID_MsRdpClient7 ist definiert als A9D7038D-B5ED-472E-9C47-94BEA90A5910 CLSID_MsRdpClient7NotSafeForScripting ist definiert als 54D38BF7-B1EF-4479-9674-1BD6EA465258 CLSID_MsRdpClient8 ist definiert als 5F681803-2900-4C43-A1CC-CF405404A676 CLSID_MsRdpClient8NotSafeForScripting ist definiert als A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9 ist definiert als 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting ist definiert als 8B918B82-7985-4C24-89DF-C33AD2BBFBCD CLSID_MsRdpClientNotSafeForScripting ist definiert als 7CACBD7B-0D99-468F-AC33-22E495C0AFE5 CLSID_MsTscAx ist definiert als 1FB464C8-09BB-4017-A2F5-EB742F04392F CLSID_MsTscAxNotSafeForScripting ist definiert als A41A4187-5A86-4E26-B40A-856F9035D9CB |
| IID |
IID_IMsTscAxEvents ist definiert als 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |