Classe MsRdpClient3

Article
06/12/2023

Microsoft RDP Client Control (redistribuable) - version 4

Cette classe implémente les interfaces suivantes.

MsRdpClient3 a les types de membres suivants :

Méthodes
Propriétés

Méthodes

La classe MsRdpClient3 possède ces méthodes.

Méthode	Description
Connecter	Lance une connexion à l’aide des propriétés actuellement définies sur le contrôle.
CreateVirtualChannels	Crée un objet de canal virtuel côté client pour chaque nom de canal virtuel spécifié.
Déconnecter	Déconnecte la connexion active.
GetVirtualChannelOptions	Récupère les options définies pour un canal virtuel.
NotifyRedirectDeviceChange	Avertit le module de redirection d’appareil du contrôle Bureau à distance ActiveX qu’un changement d’appareil s’est produit sur le système. Cette méthode transmet WM_DEVICECHANGE notifications au contrôle.
OnAuthenticationWarningDismisseded	Appelé après qu’un contrôle ActiveX affiche une boîte de dialogue d’authentification (par exemple, la boîte de dialogue d’erreur de certificat).
OnAuthenticationWarningDisplayed	Appelé avant qu’un contrôle ActiveX n’affiche une boîte de dialogue d’authentification (par exemple, la boîte de dialogue d’erreur de certificat).
OnAutoReconnected	Appelé lorsque le contrôle client s’est automatiquement reconnecté à une session distante.
OnAutoReconnecting	Appelé lorsqu’un client est en train de reconnecter automatiquement une session avec un serveur hôte de session Bureau à distance.
OnAutoReconnecting2	Appelé lorsqu’un client est en train de reconnecter automatiquement une session avec un serveur hôte de session Bureau à distance.
OnChannelReceivedData	Appelé lorsque le client reçoit des données sur un canal virtuel pouvant faire l’objet d’un script.
OnConfirmClose	Appelé lorsque le client appelle la méthode IMsRdpClient::RequestClose .
OnConnected	Appelé lorsque le contrôle client est en train d’établir une connexion avec un serveur hôte de session Bureau à distance.
OnConnecting	Appelé lorsque le contrôle client commence à se connecter à un serveur en réponse à un appel à IMsTscAx::Connect.
OnConnectionBarPullDown	Appelé lorsque l’utilisateur a glissé vers le bas dans la barre de connexion.
OnDevicesButtonPressed	Appelé lorsque le bouton des appareils dans la barre de connexion a été enfoncé.
OnDisconnected	Appelé lorsque le contrôle client a été déconnecté du serveur hôte de session Bureau à distance.
OnEnterFullScreenMode	Appelé lorsque le client passe en mode plein écran. Par exemple, cet événement est appelé lorsque l’utilisateur appuie sur la combinaison de touches de raccourci en mode plein écran (CTRL+ALT+BREAK).
OnFatalError	Appelé lorsque le contrôle client rencontre une erreur irrécupérable.
OnFocusReleased	Appelée lorsque la combinaison de touches de mise au point de mise en production est enfoncée. Par exemple, cet événement est appelé lorsque l’utilisateur appuie sur ctrl+alt+flèche gauche ou ctrl+alt+flèche droite.
OnIdleTimeoutNotification	Appelé lorsqu’aucune entrée de souris ou de clavier n’a été effectuée par l’utilisateur pendant la période définie par la méthode IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout .
OnLeaveFullScreenMode	Appelé lorsque le client quitte le mode plein écran. Par exemple, cet événement est appelé lorsque l’utilisateur appuie sur la combinaison de touches de raccourci en mode plein écran (CTRL+ALT+BREAK).
OnLoginComplete	Appelé lorsque le contrôle client s’est correctement connecté à un serveur hôte de session Bureau à distance, après l’affichage de la boîte de dialogue Ouverture de session Windows.
OnLogonError	Appelé lorsqu’une erreur d’ouverture de session ou un autre événement d’ouverture de session se produit.
OnMouseInputModeChanged	Appelé lorsque le mode d’entrée de la souris a changé.
OnNetworkStatusChanged	Appelé lorsque le status réseau a changé.
OnReceivedTSPublicKey	Appelé pendant la séquence de connexion lorsque le client récupère la clé publique à partir du serveur. Cet événement n’est appelé que si la propriété NotifyTSPublicKey est VARIANT_TRUE.
OnRemoteDesktopSizeChange	Appelé pour indiquer que la taille du contrôle client sur le Bureau à distance a changé en réponse à une opération de contrôle client.
OnRemoteProgramDisplayed	Appelé lorsqu’un programme RemoteApp s’affiche.
OnRemoteProgramResult	Appelé lorsqu’un programme RemoteApp retourne un résultat au contrôle client.
OnRemoteWindowDisplayed	Appelé lorsqu’une fenêtre RemoteApp est affichée.
OnRequestContainerMinimize	Appelé lorsque l’utilisateur appuie sur le bouton Réduire de la barre de connexion en mode plein écran. Le déclenchement de cet événement est une demande de réduction de l’application conteneur.
OnRequestGoFullScreen	Appelé lorsque le client demande de passer en mode plein écran et que la méthode IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen est appelée pour définir la propriété ContainerHandledFullScreen sur une valeur différente de zéro.
OnRequestLeaveFullScreen	Appelé lorsque le client demande à quitter le mode plein écran et que la propriété IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen a été définie sur une valeur différente de zéro.
OnServiceMessageReceived	Appelé lorsque le client reçoit un message système.
OnUserNameAcquired	Appelé lorsque le nom d’utilisateur a été acquis par le contrôle.
OnWarning	Appelé lorsque le contrôle client rencontre une condition d’erreur qui n’est pas irrécupérable.
RequestClose	Demande un arrêt normal du contrôle client.
ResetPassword	Réinitialise tous les états de mot de passe dans le contrôle.
SendKeys	Envoie une série de séquences de touches au contrôle. Les séquences de touches sont sous forme de code d’analyse, qui correspond aux données de clavier des touches physiques réelles.
SendOnVirtualChannel	Envoie des données au serveur hôte de session Bureau à distance via un canal virtuel créé précédemment à l’aide de la méthode IMsTscAx::CreateVirtualChannels .
SetVirtualChannelOptions	Définit les options de canal virtuel pour le contrôle client.

Propriétés

La classe MsRdpClient3 a ces propriétés.

Propriété	Type d’accès	Description
AdvancedSettings	Lecture seule	Pointeur d’interface IMsTscAdvancedSettings .
AdvancedSettings2	Lecture seule	Pointeur vers l’interface IMsRdpClientAdvancedSettings , utilisée pour définir des paramètres avancés pour le contrôle client.
AdvancedSettings3	Lecture seule	Pointeur vers l’interface IMsRdpClientAdvancedSettings2 , utilisée pour définir des paramètres avancés pour le contrôle client.
AdvancedSettings4	Lecture seule	Pointeur vers l’interface IMsRdpClientAdvancedSettings3 , utilisée pour définir des paramètres avancés pour le contrôle client.
BinaryPassword	Lecture/écriture	Cette propriété n'est pas prise en charge.
BinarySalt	Lecture/écriture	Cette propriété n'est pas prise en charge.
CipherStrength	Lecture seule	Puissance de chiffrement maximale du contrôle actuel.
ClearTextPassword	Écriture seule	Mot de passe du contrôle ActiveX bureau à distance, au format texte en clair.
ColorDepth	Lecture/écriture	Profondeur de couleur du contrôle actuel.
Connecté	Lecture seule	État de connexion du contrôle actuel.
ConnectedStatusText	Lecture/écriture	Texte affiché dans la zone cliente du contrôle alors que le contrôle est dans l’état connecté.
ConnectingText	Lecture/écriture	Texte qui apparaît centré dans le contrôle pendant la connexion du contrôle.
DesktopHeight	Lecture/écriture	Hauteur du contrôle actuel, en pixels, sur le Bureau à distance initial.
DesktopWidth	Lecture/écriture	Largeur du contrôle actuel, en pixels, sur le Bureau à distance initial.
DisconnectedText	Lecture/écriture	Texte qui apparaît centré dans le contrôle avant l’arrêt d’une connexion.
Domain	Lecture/écriture	Domaine auquel l’utilisateur actuel se connecte.
ExtendedDisconnectReason	Lecture seule	Informations étendues sur la raison de la déconnexion du contrôle client.
Fullscreen	Lecture/écriture	Indique si le contrôle est en mode plein écran.
FullScreenTitle	Écriture seule	Titre de la fenêtre affiché lorsque le contrôle est en mode plein écran.
HorizontalScrollBarVisible	Lecture seule	Indique si le contrôle a affiché une barre de défilement horizontale.
PortablePassword	Lecture/écriture	Cette propriété n'est pas prise en charge.
PortableSalt	Lecture/écriture	Cette propriété n'est pas prise en charge.
SecuredSettings	Lecture seule	Pointeur d’interface IMsTscSecuredSettings .
SecuredSettings2	Lecture seule	Pointeur vers l’interface IMsRdpClientSecuredSettings , utilisée pour définir des paramètres sécurisés pour le contrôle client.
SecuredSettingsEnabled	Lecture seule	Indique si l’interface IMsTscSecuredSettings est disponible.
Serveur	Lecture/écriture	Nom du serveur auquel le contrôle actuel est connecté.
StartConnected	Lecture/écriture	Indique si le contrôle établit la connexion au serveur Hôte de session Bureau à distance immédiatement au démarrage.
UserName	Lecture/écriture	Informations d’identification d’ouverture de session du nom d’utilisateur.
Version	Lecture seule	Numéro de version du contrôle actuel.
VerticalScrollBarVisible	Lecture seule	Indique si le contrôle affiche une barre de défilement verticale.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Bibliothèque de types	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient3 est défini comme 7584C670-2274-4EFB-B00B-D6AABA6D3850

Voir aussi

Classes de contrôle ActiveX Bureau à distance