MsRdpClient6-Klasse
Microsoft RDP-Clientsteuerung (verteilbar): Version 7
Diese Klasse implementiert die folgenden Schnittstellen.
- IMsRdpClient6
- IMsRdpClient5
- IMsRdpClient4
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
- IMsRdpClientNonScriptable2
- IMsRdpClientNonScriptable3
- IMsRdpClientNonScriptable4
MsRdpClient6 verfügt über die folgenden Membertypen:
Methoden
Die MsRdpClient6-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. |
| GetErrorDescription | Ruft die Fehlercodes und Fehlermeldungen ab. |
| 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 MsRdpClient6-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. |
| AdvancedSettings6 |
Schreibgeschützt |
Die Schnittstelle zu IMsRdpClientAdvancedSettings5. |
| AdvancedSettings7 |
Schreibgeschützt |
Die Schnittstelle zu IMsRdpClientAdvancedSettings6. |
| AllowCredentialSaving |
Lesen/Schreiben |
Gibt an, ob im Dialogfeld "Anmeldeinformationen" ein Kontrollkästchen zum Speichern von Anmeldeinformationen angezeigt 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 verbindet. |
| ConnectionBarText |
Lesen/Schreiben |
Die Textzeichenfolge, die für die Verbindungsleiste angezeigt werden soll. |
| 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. |
| DeviceCollection |
Schreibgeschützt |
Die Sammlung von PnP-Geräten, die für die Umleitung verfügbar sind. |
| 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. |
| DriveCollection |
Schreibgeschützt |
Die Auflistung der Datenträgerlaufwerke, die für die Umleitung verfügbar sind. |
| EnableCredSspSupport |
Lesen/Schreiben |
Gibt an, ob CredSSP für diese Verbindung aktiviert ist. |
| 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. |
| LaunchedViaClientShellInterface |
Lesen/Schreiben |
Gibt an, ob der Benutzer das Clientsteuerelement über die RD-Webzugriff-Schnittstelle gestartet hat. |
| MarkRdpSettingsSecure |
Lesen/Schreiben |
Gibt an, ob RDP-Einstellungen als sicher markiert sind. |
| MsRdpClientShell |
Schreibgeschützt |
Die Clienteinstellungen für das Webportalstarter. |
| NegotiateSecurityLayer |
Lesen/Schreiben |
Gibt an, ob die NegotiateSecurityLayer-Einstellung für diese Verbindung unterstützt wird.[!Note] |
| PortablePassword |
Lesen/Schreiben |
Diese Eigenschaft wird nicht unterstützt. |
| PortableSalt |
Lesen/Schreiben |
Diese Eigenschaft wird nicht unterstützt. |
| PromptForCredentials |
Lesen/Schreiben |
Gibt an, ob die Aufforderung zum Eingeben von Anmeldeinformationen angezeigt werden soll. |
| PromptForCredsOnClient |
Lesen/Schreiben |
Gibt an, ob das Clientsteuerelement ein Dialogfeld anzeigt, in dem zur Eingabe von Anmeldeinformationen aufgefordert wird. |
| PublisherCertificateChain |
Lesen/Schreiben |
Gibt die Zertifikatkette des Herausgebers an. Die Kette wird in einer Variante vom Typ VT_BYREF gespeichert, die einen Zeiger auf eine CERT_CHAIN_CONTEXT-Struktur enthält. |
| RedirectDynamicDevices |
Lesen/Schreiben |
Gibt an, ob dynamisch angefügte PnP-Geräte, die während einer Sitzung aufzählt werden, für die Umleitung verfügbar sind. |
| RedirectDynamicDrives |
Lesen/Schreiben |
Gibt an, ob dynamisch angefügte PnP-Laufwerke, die während einer Sitzung aufzählt werden, für die Umleitung verfügbar sind. |
| RedirectionWarningType |
Lesen/Schreiben |
Steuert das Vorhandensein und die Darstellung des Umleitungsdialogfelds. |
| RemoteProgram |
Schreibgeschützt |
Die RemoteApp-Clienteinstellung. |
| 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. |
| ShowRedirectionWarningDialog |
Lesen/Schreiben |
Gibt an, ob das Dialogfeld "Umleitungssicherheitswarnung" vor dem Starten einer Sitzung angezeigt werden soll. |
| StartConnected |
Lesen/Schreiben |
Gibt an, ob das Steuerelement die RD-Sitzungshost Serververbindung sofort beim Start herstellt. |
| TransportSettings |
Schreibgeschützt |
Die Rd-Gatewayeinstellung des Clients. |
| TransportSettings2 |
Schreibgeschützt |
Die Schnittstelle zu IMsRdpClientTransportSettings2. |
| TrustedZoneSite |
Lesen/Schreiben |
Gibt an, ob die Website, von der aus der Benutzer die Verbindung gestartet hat, in der Liste der vertrauenswürdigen Websites des Clientcomputers enthalten ist. |
| UIParentWindowHandle |
Lesen/Schreiben |
Das Fensterhandle, das das übergeordnete Fenster für das Steuerelement sein soll. Dadurch können alle vom Steuerelement angezeigten Fenster 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. |
| WarnAboutClipboardRedirection |
Lesen/Schreiben |
Gibt an, ob das Sicherheitswarnungsdialogfeld eine Warnung zur Umleitung der Zwischenablage enthalten soll, bevor eine Sitzung gestartet wird. |
| WarnAboutPrinterRedirection |
Lesen/Schreiben |
Gibt an, ob im Dialogfeld "Umleitung" eine Meldung zur Druckerumleitung angezeigt wird, bevor eine Sitzung gestartet wird. |
| WarnAboutSendingCredentials |
Lesen/Schreiben |
Gibt an, ob die Sicherheitswarnung eine Warnung zum Senden von Anmeldeinformationen an den Remoteserver enthalten soll, bevor eine Sitzung gestartet wird. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID _ MsRdpClient6 ist als 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 definiert. |