MsRdpClient-Klasse
Microsoft RDP-Clientsteuerung (verteilbar) – Version 2
Diese Klasse implementiert die folgenden Schnittstellen.
MsRdpClient verfügt über folgende Membertypen:
Methoden
Die MsRdpClient-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 Modul für die Geräteumleitung des ActiveX-Remotedesktopsteuerelements, dass eine Geräteänderung auf dem System erfolgt ist. Diese Methode übergibt WM_DEVICECHANGE Benachrichtigungen an das Steuerelement. |
| OnAuthenticationWarningDismissed | Wird aufgerufen, nachdem ein ActiveX-Steuerelement ein Authentifizierungsdialogfeld anzeigt (z. B. das Zertifikatfehlerdialogfeld). |
| 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 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 der Verbindungsleiste nach unten gezogen wurde. |
| OnDevicesButtonPressed | Wird aufgerufen, wenn die Geräteschaltfläche in der Verbindungsleiste gedrückt wurde. |
| OnDisconnected | Wird aufgerufen, wenn die Verbindung zwischen dem Clientsteuerelement und dem RD-Sitzungshostserver getrennt wurde. |
| OnEnterFullScreenMode | Wird aufgerufen, wenn der Client in den Vollbildmodus wechselt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination im Vollbildmodus (STRG+ALT+BREAK) drückt. |
| OnFatalError | Wird aufgerufen, wenn für das Clientsteuerelement ein schwerwiegender Fehler auftritt. |
| OnFocusReleased | Wird aufgerufen, wenn die Tastenkombination "Freigabefokus" gedrückt wird. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer STRG+ALT+NACH-LINKS-TASTE 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 ausgeführt hat. |
| OnLeaveFullScreenMode | Wird aufgerufen, wenn der Client den Vollbildmodus verlässt. Dieses Ereignis wird beispielsweise aufgerufen, wenn der Benutzer die Tastenkombination im Vollbildmodus (STRG+ALT+BREAK) drückt. |
| OnLoginComplete | Wird aufgerufen, wenn sich das Clientsteuerelement erfolgreich bei einem RD-Sitzungshostserver angemeldet hat, und zwar nach 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 Wert ungleich null festzulegen. |
| OnRequestLeaveFullScreen | Wird aufgerufen, wenn der Client anfordert, den Vollbildmodus zu verlassen, und die IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen-Eigenschaft auf einen Wert ungleich null festgelegt wurde. |
| OnServiceMessageReceived | Wird aufgerufen, wenn der Client eine Systemnachricht empfängt. |
| OnUserNameAcquired | Wird aufgerufen, wenn der Benutzername vom Steuerelement abgerufen wurde. |
| OnWarning | Wird aufgerufen, wenn für das Clientsteuerelement eine Fehlerbedingung auftritt, 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 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 MsRdpClient-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. |
|
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. |
|
ConnectingText |
Lesen/Schreiben |
Der Text, der zentriert im Steuerelement angezeigt wird, während das Steuerelement eine Verbindung herstellt. |
|
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. |
|
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. |
|
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. |
|
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 gesicherter 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-Sitzungshostserververbindung sofort nach dem 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) |
WindowsServer 2008 |
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient ist definiert als 791fa017-2de3-492e-acc5-53c67a2b94d0 |