Classe MsRdpClient
Contrôle client Rdp Microsoft (redistribuable) - version 2
Cette classe implémente les interfaces suivantes.
MsRdpClient a les types de membres suivants :
Méthodes
La classe MsRdpClient 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 gracieux du contrôle client. |
| ResetPassword | Réinitialise tous les états de mot de passe dans le contrôle. |
| SendKeys | Envoie une série de frappes au contrôle. Les frappes sont sous forme de code d’analyse, c’est-à-dire les données du 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 MsRdpClient possède 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é pour définir les 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 |
Force de chiffrement maximale du contrôle actuel. |
|
ClearTextPassword |
Écriture seule |
Mot de passe du contrôle ActiveX Bureau à distance, au format en texte clair. |
|
ColorDepth |
Lecture/écriture |
Profondeur de couleur du contrôle actuel. |
|
Connecté |
Lecture seule |
État de connexion du contrôle actuel. |
|
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 la fin d’une connexion. |
|
Domain |
Lecture/écriture |
Domaine sur lequel 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é 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 |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient est défini comme 791fa017-2de3-492e-acc5-53c67a2b94d0 |