Freigeben über


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.

  1. Rufen Sie IUnknown::QueryInterface im RDP-Clientsteuerungsobjekt auf, um einen Zeiger auf die IConnectionPointContainer-Schnittstelle abzurufen.
  2. Rufen Sie IConnectionPointContainer::FindConnectionPoint auf, und geben Sie __uuidof(IMsTscAxEvents) als riid-Parameter an, um einen Zeiger auf die IConnectionPoint-Schnittstelle der Clientsteuerelementereignisse abzurufen.
  3. 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
MsTscAx.dll
DLL
MsTscAx.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

Weitere Informationen

IDispatch

Remotedesktop-Webverbindungsreferenz