MsRdpClient4a-Klasse
Microsoft RDP-Clientsteuerung (verteilbar): Version 5a
Diese Klasse implementiert die folgenden Schnittstellen.
- IMsRdpClient4
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
- IMsRdpClientNonScriptable2
MsRdpClient4a verfügt über die folgenden Membertypen:
Methoden
Die MsRdpClient4a-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 an fordert, den Vollbildmodus zu verlassen, und die Eigenschaft IMsTscAdvancedSettings::p ut _ ContainerHandledFullScreen wurde auf einen Wert ungleich 0 festgelegt. |
| 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 MsRdpClient4a-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. |
| AdvancedSettings4 |
Schreibgeschützt |
Zeiger auf die IMsRdpClientAdvancedSettings3-Schnittstelle, die zum Festlegen erweiterter Einstellungen für das Clientsteuerelement 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 |
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 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 |
|
| DLL |
|
| CLSID |
CLSID _ MsRdpClient4a ist als 54CE37E0-9834-41AE-9896-4DAB69DC022B definiert. |