MsRdpClient6NotSafeForScripting-Klasse

Microsoft RDP-Clientsteuerung – Version 7

Diese Klasse implementiert die folgenden Schnittstellen.

MsRdpClient6NotSafeForScripting verfügt über die folgenden Membertypen:

Methoden

Die MsRdpClient6NotSafeForScripting-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 Modul zur Geräteumleitung des ActiveX-Remotedesktops, dass eine Geräteänderung auf dem System aufgetreten ist. Diese Methode übergibt WM_DEVICECHANGE Benachrichtigungen an das Steuerelement.
OnAuthenticationWarningDismissed Nach einem ActiveX-Steuerelement aufgerufen, wird ein Authentifizierungsdialogfeld angezeigt (z. B. das Dialogfeld Zertifikatfehler).
OnAuthenticationWarningDisplayed Wird vor einem ActiveX-Steuerelement aufgerufen, wird ein Authentifizierungsdialogfeld angezeigt (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 die Verbindungsleiste gezogen wurde.
OnDevicesButtonPressed Wird aufgerufen, wenn die Schaltfläche Geräte in der Verbindungsleiste gedrückt wurde.
OnDisconnected Wird aufgerufen, wenn das Clientsteuerelement vom RD-Sitzungshostserver getrennt wurde.
OnEnterFullScreenMode Wird aufgerufen, wenn der Client in den Vollbildmodus wechselt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination für den Vollbildmodus (STRG+ALT+BREAK) drückt.
OnFatalError Wird aufgerufen, wenn beim Clientsteuerelement ein schwerwiegender Fehler auftritt.
OnFocusReleased Wird aufgerufen, wenn die Tastenkombination des Freigabefokus gedrückt wird. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer STRG+ALT+NACH-LINKS oder die Tastenkombination 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 vorgenommen 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 (STRG+ALT+BREAK) drückt.
OnLoginComplete Wird aufgerufen, wenn sich das Clientsteuerelement erfolgreich bei einem RD-Sitzungshostserver angemeldet hat, und folgt 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 nichtzero-Wert festzulegen.
OnRequestLeaveFullScreen Wird aufgerufen, wenn der Client anfordert, den Vollbildmodus zu verlassen, und die IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen-Eigenschaft auf einen nichtzero-Wert 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 beim Clientsteuerelement eine Fehlerbedingung auftritt, die nicht fatal 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 Tastenanschläge befinden sich in Scancodeform, d. h. die Tastaturdaten der tatsächlichen physischen Tasten.
SendOnVirtualChannel Sendet Daten an den RD-Sitzungshostserver ü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 Clientsteuerelement fest.

Eigenschaften

Die MsRdpClient6NotSafeForScripting-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 .
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 Aktivieren des Speicherns 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 herstellt.
ConnectionBarText
Lesen/Schreiben
Die Textzeichenfolge, die für die Verbindungsleiste angezeigt werden soll.
DesktopHeight
Lesen/Schreiben
Die Höhe des aktuellen Steuerelements in Pixel auf dem ersten Remotedesktop.
DesktopWidth
Lesen/Schreiben
Die Breite des aktuellen Steuerelements in Pixel auf dem ersten Remotedesktop.
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.
Domain
Lesen/Schreiben
Die Domäne, bei der sich der aktuelle Benutzer anmeldet.
DriveCollection
Schreibgeschützt
Die Sammlung von Datenträgern, 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 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.
LaunchedViaClientShellInterface
Lesen/Schreiben
Gibt an, ob der Benutzer das Clientsteuerelement über die Remotedesktop-Webzugriffsschnittstelle gestartet hat.
MarkRdpSettingsSecure
Lesen/Schreiben
Gibt an, ob RDP-Einstellungen als sicher gekennzeichnet sind.
MsRdpClientShell
Schreibgeschützt
Die Clienteinstellungen für das Webportal-Startprogramm.
NegotiateSecurityLayer
Lesen/Schreiben
Gibt an, ob die NegotiateSecurityLayer-Einstellung für diese Verbindung unterstützt wird.
Hinweis: Wenn CredSspSupport aktiviert ist und auf dem Client vorhanden ist oder SSL (Secure Sockets Layer) mit Benutzerauthentifizierung aktiviert ist, wird NegotiateSecurityLayer ignoriert.
PortablePassword
Lesen/Schreiben
Diese Eigenschaft wird nicht unterstützt.
PortableSalt
Lesen/Schreiben
Diese Eigenschaft wird nicht unterstützt.
PromptForCredentials
Lesen/Schreiben
Gibt an, ob das Dialogfeld zur Eingabe 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 Herausgeberzertifikatkette 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 aufgelistet werden, für die Umleitung verfügbar sind.
RedirectDynamicDrives
Lesen/Schreiben
Gibt an, ob dynamisch angefügte PnP-Laufwerke, die während einer Sitzung aufgelistet 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 für die Umleitungssicherheit angezeigt werden soll, bevor eine Sitzung gestartet wird.
StartConnected
Lesen/Schreiben
Gibt an, ob das Steuerelement sofort nach dem Start eine Verbindung mit dem RD-Sitzungshostserver herstellt.
TransportSettings
Schreibgeschützt
Die Client-RD-Gatewayeinstellung.
TransportSettings2
Schreibgeschützt
Die Schnittstelle zu IMsRdpClientTransportSettings2.
TrustedZoneSite
Lesen/Schreiben
Gibt an, ob sich die Website, von der aus der Benutzer die Verbindung gestartet hat, in der Liste der vertrauenswürdigen Websites des Clientcomputers befindet.
UIParentWindowHandle
Lesen/Schreiben
Das Fensterhandle, das das übergeordnete Fenster für das Steuerelement sein soll. Dadurch können alle fenster, die vom Steuerelement angezeigt werden, im Hinblick auf alle Fenster, die von der übergeordneten Anwendung angezeigt werden, ordnungsgemäß modal sein.
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.
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 Umleitungsdialogfeld 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
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
CLSID_MsRdpClient6NotSafeForScripting ist definiert als D2EA46A7-C2BF-426B-AF24-E19C44456399

Siehe auch

ActiveX-Steuerungsklassen für Remotedesktop