MsRdpClient4-Klasse

Microsoft RDP-Clientsteuerung (verteilbar): Version 5

Diese Klasse implementiert die folgenden Schnittstellen.

MsRdpClient4 verfügt über die folgenden Membertypen:

Methoden

Die MsRdpClient4-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 Geräteumleitungsmodul des Remotedesktop ActiveX, dass eine Geräteänderung auf dem System aufgetreten ist. Diese Methode übergibt WM _ DEVICECHANGE-Benachrichtigungen an das Steuerelement.
OnAuthenticationWarningDismissed Wird aufgerufen, ActiveX-Steuerelement ein Authentifizierungsdialogfeld anzeigt (z. B. das Zertifikatfehlerdialogfeld).
OnAuthenticationWarningDisplayed Wird aufgerufen, ActiveX-Steuerelement ein Authentifizierungsdialogfeld anzeigt (z. B. das Zertifikatfehlerdialogfeld).
OnAutoReconnected Wird aufgerufen, wenn das Clientsteuer steuerelement automatisch erneut eine Verbindung mit einer Remotesitzung hergestellt hat.
OnAutoReconnecting Wird aufgerufen, wenn ein Client eine Sitzung automatisch erneut mit einem RD-Sitzungshost verbindet.
OnAutoReconnecting2 Wird aufgerufen, wenn ein Client eine Sitzung automatisch erneut mit einem RD-Sitzungshost verbindet.
OnChannelReceivedData Wird aufgerufen, wenn der Client Daten in einem skriptierbaren virtuellen Kanal empfängt.
OnConfirmClose Wird aufgerufen, wenn der Client die IMsRdpClient::RequestClose-Methode aufruft.
OnConnected Wird aufgerufen, wenn das Clientsteuer steuerelement eine Verbindung mit einem serverseitigen RD-Sitzungshost wird.
Beim Herstellen einer Verbindung Wird aufgerufen, wenn das Clientsteuerelemente als Reaktion auf einen Aufruf von IMsTscAx::Verbinden.
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 das Clientsteuer steuerelement vom Server getrennt RD-Sitzungshost wurde.
OnEnterFullScreenMode Wird aufgerufen, wenn der Client in den Vollbildmodus eintritt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination für den Vollbildmodus drückt (STRG+ALT+BREAK).
OnFatalError Wird aufgerufen, wenn das Clientsteuer steuerelement einen schwerwiegenden Fehler trifft.
OnFocusReleased Wird aufgerufen, wenn die Tastenkombination für den Releasefokus gedrückt wird. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination STRG+ALT+NACH-LINKS 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 erhalten 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 drückt (STRG+ALT+BREAK).
OnLoginComplete Wird aufgerufen, wenn sich das Clientsteuerfeld erfolgreich bei einem RD-Sitzungshost-Server angemeldet hat, nachdem das Windows Angezeigt wird.
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 der Netzwerkstatus 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-Eigenschaft VARIANT TRUE _ ist.
OnRemoteDesktopSizeChange Wird aufgerufen, um anzugeben, dass sich die Größe des Clientsteuer steuerelements 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 Clientsteuerprogramm 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 Ausschlagen dieses Ereignisses ist eine Anforderung, die die Containeranwendung selbst minimiert.
OnRequestGoFullScreen Wird aufgerufen, wenn der Client den Wechsel in den Vollbildmodus an fordert, und die Methode IMsTscAdvancedSettings::p ut _ ContainerHandledFullScreen aufgerufen wird, um die ContainerHandledFullScreen-Eigenschaft auf einen Wert ungleich 0 (null) zu setzen.
OnRequestLeaveFullScreen Wird aufgerufen, wenn der Client den Vollbildmodus verlassen möchte und die Eigenschaft IMsTscAdvancedSettings::p ut _ ContainerHandledFullScreen auf einen Wert ungleich 0 festgelegt wurde.
OnServiceMessageReceived Wird aufgerufen, wenn der Client eine Systemmeldung empfängt.
OnUserNameAcquired Wird aufgerufen, wenn der Benutzername vom -Steuerelement übernommen wurde.
OnWarning Wird aufgerufen, wenn das Clientsteuer steuerelement eine Fehlerbedingung trifft, die nicht schwerwiegender ist.
RequestClose Fordert ein ordnungsgemäßes Herunterfahren des Clientsteuer steuerelements an.
Resetpassword Setzt alle Kennwortzustände im Steuerelement zurück.
SendKeys Sendet eine Reihe von Tastatureingaben an das Steuerelement. Die Tastatureingaben sind in Scancodeform, d.&a0;b. den Tastaturdaten der tatsächlichen physischen Tasten.
SendOnVirtualChannel Sendet Daten an den RD-Sitzungshost-Server über einen virtuellen Kanal, der zuvor mithilfe der IMsTscAx::CreateVirtualChannels-Methode erstellt wurde.
SetVirtualChannelOptions Legt die Optionen für den virtuellen Kanal für das Clientsteuer steuerelement fest.

Eigenschaften

Die MsRdpClient4-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 Clientsteuerfeld verwendet wird.
AdvancedSettings3
Schreibgeschützt
Zeiger auf die IMsRdpClientAdvancedSettings2-Schnittstelle, die zum Festlegen erweiterter Einstellungen für das Clientsteuerfeld verwendet wird.
AdvancedSettings4
Schreibgeschützt
Zeiger auf die IMsRdpClientAdvancedSettings3-Schnittstelle, die zum Festlegen erweiterter Einstellungen für das Clientsteuerfeld verwendet wird.
AdvancedSettings5
Schreibgeschützt
Ein IMsRdpClientAdvancedSettings4-Schnittstellenzeiger.
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 verbindet.
DesktopHeight
Lesen/Schreiben
Die Höhe des aktuellen Steuerelements auf dem ursprünglichen Remotedesktop in Pixel.
DesktopWidth
Lesen/Schreiben
Die Breite des aktuellen Steuerelements auf dem ursprünglichen Remotedesktop in Pixel.
DisconnectedText
Lesen/Schreiben
Der Text, der im Steuerelement zentriert angezeigt wird, bevor eine Verbindung beendet wird.
Domäne
Lesen/Schreiben
Die Domäne, bei der sich der aktuelle Benutzer anmeldet.
ExtendedDisconnectReason
Schreibgeschützt
Erweiterte Informationen zum Grund für die Trennung der Verbindung des Clientsteuer steuerelements.
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 Scrollleiste 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 Clientsteuerfeld 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 die Serververbindung RD-Sitzungshost beim Start eingibt.
UIParentWindowHandle
Lesen/Schreiben
Das Fensterhand handle, das als übergeordnetes Fenster für das Steuerelement verwendet werden soll. Dadurch können alle fenster, die vom -Steuerelement angezeigt werden, in Bezug auf alle fenster, die von der übergeordneten Anwendung angezeigt werden, ordnungsgemäß modal sein.
Nutzername
Lesen/Schreiben
Die 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)
Windows Server 2008
Typbibliothek
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
CLSID _ MsRdpClient4 ist als 4EDCB26C-D24C-4E72-AF07-B576699AC0DE definiert.

Siehe auch

Remotedesktop ActiveX Steuerelementklassen