MsRdpClient2-Klasse

  • Artikel

Microsoft RDP-Clientsteuerung (verteilbar) – Version 3

Diese Klasse implementiert die folgenden Schnittstellen.

MsRdpClient2 verfügt über folgende Membertypen:

Methoden

Die MsRdpClient2-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
Verbinden Initiiert eine Verbindung mithilfe der eigenschaften, die derzeit für das Steuerelement festgelegt sind.
CreateVirtualChannels Erstellt ein clientseitiges virtuelles Kanalobjekt für jeden angegebenen namen des virtuellen Kanals.
Trennen Trennt die aktive Verbindung.
GetVirtualChannelOptions Ruft die für einen virtuellen Kanal festgelegten Optionen ab.
NotifyRedirectDeviceChange Benachrichtigt das Modul für die Geräteumleitung des ActiveX-Remotedesktopsteuerelements, dass eine Geräteänderung auf dem System erfolgt ist. Diese Methode übergibt WM_DEVICECHANGE Benachrichtigungen an das Steuerelement.
OnAuthenticationWarningDismissed Wird aufgerufen, nachdem ein ActiveX-Steuerelement ein Authentifizierungsdialogfeld anzeigt (z. B. das Zertifikatfehlerdialogfeld).
OnAuthenticationWarningDisplayed Wird aufgerufen, bevor ein ActiveX-Steuerelement ein Authentifizierungsdialogfeld anzeigt (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 der Verbindungsleiste nach unten gezogen wurde.
OnDevicesButtonPressed Wird aufgerufen, wenn die Geräteschaltfläche in der Verbindungsleiste gedrückt wurde.
OnDisconnected Wird aufgerufen, wenn die Verbindung zwischen dem Clientsteuerelement und dem RD-Sitzungshostserver getrennt wurde.
OnEnterFullScreenMode Wird aufgerufen, wenn der Client in den Vollbildmodus wechselt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination im Vollbildmodus (STRG+ALT+BREAK) drückt.
OnFatalError Wird aufgerufen, wenn für das Clientsteuerelement ein schwerwiegender Fehler auftritt.
OnFocusReleased Wird aufgerufen, wenn die Tastenkombination "Freigabefokus" gedrückt wird. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer STRG+ALT+NACH-LINKS-TASTE oder 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 ausgeführt hat.
OnLeaveFullScreenMode Wird aufgerufen, wenn der Client den Vollbildmodus verlässt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination im Vollbildmodus (STRG+ALT+BREAK) drückt.
OnLoginComplete Wird aufgerufen, wenn sich das Clientsteuerelement erfolgreich bei einem RD-Sitzungshostserver angemeldet hat, und zwar nach 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 Wert ungleich null festzulegen.
OnRequestLeaveFullScreen Wird aufgerufen, wenn der Client anfordert, den Vollbildmodus zu verlassen, und die IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen-Eigenschaft auf einen Wert ungleich null festgelegt wurde.
OnServiceMessageReceived Wird aufgerufen, wenn der Client eine Systemnachricht empfängt.
OnUserNameAcquired Wird aufgerufen, wenn der Benutzername vom Steuerelement abgerufen wurde.
OnWarning Wird aufgerufen, wenn für das Clientsteuerelement eine Fehlerbedingung auftritt, die nicht schwerwiegend ist.
RequestClose Fordert ein ordnungsgemäßes Herunterfahren des Clientsteuerelements an.
Resetpassword Setzt alle Kennwortzustände im Steuerelement zurück.
SendKeys Sendet eine Reihe von Tastenanschlägen an das Steuerelement. Die Tastaturanschläge befinden sich im Scancodeformat, d. h. die Tastaturdaten der tatsächlichen physischen Tasten.
SendOnVirtualChannel Sendet Daten über einen virtuellen Kanal, der zuvor mit der IMsTscAx::CreateVirtualChannels-Methode erstellt wurde, an den RD-Sitzungshostserver.
SetVirtualChannelOptions Legt die Optionen für den virtuellen Kanal für das Clientsteuerelement fest.

Eigenschaften

Die MsRdpClient2-Klasse verfügt über diese Eigenschaften.

Eigenschaft Zugriffstyp BESCHREIBUNG
AdvancedSettings
 Schreibgeschützt
 Ein IMsTscAdvancedSettings-Schnittstellenzeiger .
AdvancedSettings2
 Schreibgeschützt
 Zeiger auf die IMsRdpClientAdvancedSettings-Schnittstelle , die zum Festlegen erweiterter Einstellungen für das Clientsteuerelement verwendet wird.
AdvancedSettings3
 Schreibgeschützt
 Zeiger auf die IMsRdpClientAdvancedSettings2-Schnittstelle , die zum Festlegen erweiterter Einstellungen für das Clientsteuerelement verwendet wird.
BinaryPassword
 Lesen/Schreiben
 Diese Eigenschaft wird nicht unterstützt.
BinarySalt
 Lesen/Schreiben
 Diese Eigenschaft wird nicht unterstützt.
CipherStrength
 Schreibgeschützt
 Die maximale Verschlüsselungsstärke des aktuellen Steuerelements.
ClearTextPassword
 Lesegeschützt
 Das Remotedesktop-ActiveX-Steuerelementkennwort im Klartextformat.
ColorDepth
 Lesen/Schreiben
 Farbtiefe des aktuellen Steuerelements.
Verbunden
 Schreibgeschützt
 Der Verbindungsstatus des aktuellen Steuerelements.
ConnectedStatusText
 Lesen/Schreiben
 Text, der im Clientbereich des Steuerelements angezeigt wird, während sich das Steuerelement im verbundenen Zustand befindet.
ConnectingText
 Lesen/Schreiben
 Der Text, der zentriert im Steuerelement angezeigt wird, während das Steuerelement eine Verbindung herstellt.
DesktopHeight
 Lesen/Schreiben
 Die Höhe des aktuellen Steuerelements in Pixel auf dem anfänglichen Remotedesktop.
DesktopWidth
 Lesen/Schreiben
 Die Breite des aktuellen Steuerelements in Pixel auf dem anfänglichen Remotedesktop.
DisconnectedText
 Lesen/Schreiben
 Der Text, der zentriert im Steuerelement angezeigt wird, bevor eine Verbindung beendet wird.
Domain
 Lesen/Schreiben
 Die Domäne, bei der sich der aktuelle Benutzer anmeldet.
ExtendedDisconnectReason
 Schreibgeschützt
 Erweiterte Informationen zum Grund für die Trennung des Clientsteuerelements.
Fullscreen
 Lesen/Schreiben
 Gibt an, ob sich das Steuerelement im Vollbildmodus befindet.
FullScreenTitle
 Lesegeschützt
 Der Fenstertitel, der angezeigt wird, wenn sich das Steuerelement im Vollbildmodus befindet.
HorizontalScrollBarVisible
 Schreibgeschützt
 Gibt an, ob das Steuerelement eine horizontale Bildlaufleiste angezeigt hat.
PortablePassword
 Lesen/Schreiben
 Diese Eigenschaft wird nicht unterstützt.
PortableSalt
 Lesen/Schreiben
 Diese Eigenschaft wird nicht unterstützt.
SecuredSettings
 Schreibgeschützt
 Ein IMsTscSecuredSettings-Schnittstellenzeiger .
SecuredSettings2
 Schreibgeschützt
 Zeiger auf die IMsRdpClientSecuredSettings-Schnittstelle , die zum Festlegen geschützter Einstellungen für das Clientsteuerelement verwendet wird.
SecuredSettingsEnabled
 Schreibgeschützt
 Gibt an, ob die IMsTscSecuredSettings-Schnittstelle verfügbar ist.
Server
 Lesen/Schreiben
 Der Name des Servers, mit dem das aktuelle Steuerelement verbunden ist.
StartConnected
 Lesen/Schreiben
 Gibt an, ob das Steuerelement sofort nach dem Start eine Verbindung mit dem RD-Sitzungshostserver herstellt.
Nutzername
 Lesen/Schreiben
 Anmeldeinformationen für den Benutzernamen.
Version
 Schreibgeschützt
 Die Versionsnummer des aktuellen Steuerelements.
VerticalScrollBarVisible
 Schreibgeschützt
 Gibt an, ob das Steuerelement eine vertikale Bildlaufleiste anzeigt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008
Typbibliothek
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
 CLSID_MsRdpClient2 ist definiert als 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A

Siehe auch

ActiveX-Remotedesktop-Steuerelementklassen