MsRdpClient2-Klasse
Microsoft RDP-Clientsteuerung (verteilbar) – Version 3
Diese Klasse implementiert die folgenden Schnittstellen.
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
MsRdpClient2 verfügt über folgende Typen von Membern:
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 Geräteumleitungsmodul über das Remotedesktop ActiveX-Steuerelement, dass eine Geräteänderung auf dem System aufgetreten ist. Diese Methode übergibt WM _ DEVICECHANGE-Benachrichtigungen an das Steuerelement. |
| OnAuthenticationWarningDismissed | Wird aufgerufen, nachdem ein ActiveX-Steuerelement ein Authentifizierungsdialogfeld anzeigt (z. B. das Dialogfeld zertifikatfehler). |
| 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 eine Sitzung automatisch mit einem RD-Sitzungshost Server verbindet. |
| OnAutoReconnecting2 | Wird aufgerufen, wenn ein Client gerade eine Sitzung automatisch mit einem RD-Sitzungshost Server verbindet. |
| 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-Sitzungshost Server herstellen soll. |
| OnConnecting | Wird aufgerufen, wenn das Clientsteuerelement als Reaktion auf einen Aufruf von IMsTscAx::Verbindeneine 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 das Clientsteuerelement vom RD-Sitzungshost Server getrennt wurde. |
| OnEnterFullScreenMode | Wird aufgerufen, wenn der Client in den Vollbildmodus wechselt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination im Vollbildmodus drückt (STRG+ALT+BREAK). |
| OnFatalError | Wird aufgerufen, wenn beim Clientsteuerelement ein schwerwiegender Fehler auftritt. |
| OnFocusReleased | Wird aufgerufen, wenn die Tastenkombination des Releasefokus gedrückt wird. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer strg+ALT+NACH-LINKS-TASTE oder die Tastenkombination STRG+ALT+NACH-RECHTS 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 im Vollbildmodus drückt (STRG+ALT+BREAK). |
| OnLoginComplete | Wird aufgerufen, wenn sich das Clientsteuerelement erfolgreich bei einem RD-Sitzungshost-Server angemeldet hat. Folgen Sie dazu 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 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 Clientsteuerelements auf dem Remotedesktop als Reaktion auf einen Clientsteuerelementvorgang 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 den Wechsel in den Vollbildmodus anfordert und die IMsTscAdvancedSettings::p ut _ ContainerHandledFullScreen-Methode aufgerufen wird, um die ContainerHandledFullScreen-Eigenschaft auf einen Wert ungleich 0 (null) festzulegen. |
| OnRequestLeaveFullScreen | Wird aufgerufen, wenn der Client anfordert, den Vollbildmodus zu verlassen, und die Eigenschaft IMsTscAdvancedSettings::p ut _ ContainerHandledFullScreen auf einen Wert ungleich 0 (null) 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 das Clientsteuerelement eine Fehlerbedingung erkennt, 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 Tastatureingaben an das Steuerelement. Die Tastatureingaben befinden sich in Scancodeform, d.h. den Tastaturdaten der tatsächlichen physischen Tasten. |
| SendOnVirtualChannel | Sendet Daten an den RD-Sitzungshost Server über einen virtuellen Kanal, der zuvor mit der IMsTscAx::CreateVirtualChannels-Methode erstellt wurde. |
| 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 |
Der 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 im Steuerelement zentriert angezeigt wird, während das Steuerelement eine Verbindung herstellt. |
| DesktopHeight |
Lesen/Schreiben |
Die Höhe des aktuellen Steuerelements auf dem ersten Remotedesktop in Pixel. |
| DesktopWidth |
Lesen/Schreiben |
Die Breite des aktuellen Steuerelements auf dem ersten 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 der 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 die RD-Sitzungshost Serververbindung sofort beim Start herstellt. |
| 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 |
|
| DLL |
|
| CLSID |
CLSID _ MsRdpClient2 ist als 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A definiert. |