Classe MsRdpClient5
Contrôle client Microsoft RDP (redistribuable) - version 6
Cette classe implémente les interfaces suivantes.
- IMsRdpClient5
- IMsRdpClient4
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
- IMsRdpClientNonScriptable2
- IMsRdpClientNonScriptable3
MsRdpClient5 a les types de membres suivants :
Méthodes
La classe MsRdpClient5 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. |
| GetErrorDescription | Récupère les codes d’erreur et les messages d’erreur. |
| 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 MsRdpClient5 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. |
|
AdvancedSettings5 |
Lecture seule |
Pointeur d’interface IMsRdpClientAdvancedSettings4 . |
|
AdvancedSettings6 |
Lecture seule |
Interface vers IMsRdpClientAdvancedSettings5. |
|
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. |
|
ConnectionBarText |
Lecture/écriture |
Chaîne de texte à afficher pour la barre de connexion. |
|
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. |
|
DeviceCollection |
Lecture seule |
Collection d’appareils PnP disponibles pour la redirection. |
|
DisconnectedText |
Lecture/écriture |
Texte qui apparaît centré dans le contrôle avant l’arrêt d’une connexion. |
|
Domaine |
Lecture/écriture |
Domaine auquel l’utilisateur actuel se connecte. |
|
DriveCollection |
Lecture seule |
Collection de lecteurs de disque disponibles pour la redirection. |
|
EnableCredSspSupport |
Lecture/écriture |
Spécifie si CredSSP est activé pour cette connexion. |
|
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. |
|
MsRdpClientShell |
Lecture seule |
Paramètres client pour le lanceur de portail web. |
|
NegotiateSecurityLayer |
Lecture/écriture |
Spécifie si le paramètre NegotiateSecurityLayer est pris en charge pour cette connexion. Note: Lorsque CredSspSupport est activé et présent sur le client, ou lorsque SSL (Secure Sockets Layer) est activé avec l’authentification utilisateur, NegotiateSecurityLayer est ignoré. |
|
PortablePassword |
Lecture/écriture |
Cette propriété n'est pas prise en charge. |
|
PortableSalt |
Lecture/écriture |
Cette propriété n'est pas prise en charge. |
|
PromptForCredentials |
Lecture/écriture |
Spécifie si la boîte de dialogue d’invite d’informations d’identification doit être affichée. |
|
RedirectDynamicDevices |
Lecture/écriture |
Spécifie si les appareils PnP attachés dynamiquement qui sont énumérés dans une session sont disponibles pour la redirection. |
|
RedirectDynamicDrives |
Lecture/écriture |
Spécifie si les lecteurs PnP attachés dynamiquement qui sont énumérés dans une session sont disponibles pour la redirection. |
|
RemoteProgram |
Lecture seule |
Paramètre RemoteApp du client. |
|
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. |
|
Server |
Lecture/écriture |
Nom du serveur auquel le contrôle actuel est connecté. |
|
ShowRedirectionWarningDialog |
Lecture/écriture |
Spécifie si la boîte de dialogue d’avertissement de sécurité de redirection doit être affichée avant de démarrer une session. |
|
StartConnected |
Lecture/écriture |
Indique si le contrôle établit la connexion au serveur Hôte de session Bureau à distance immédiatement au démarrage. |
|
TransportSettings |
Lecture seule |
Paramètre de passerelle des services Bureau à distance client. |
|
UIParentWindowHandle |
Lecture/écriture |
Handle de fenêtre qui doit être la fenêtre parente du contrôle. Cela permet à toutes les fenêtres affichées par le contrôle d’être correctement modales par rapport aux fenêtres affichées par l’application parente. |
|
Nom d'utilisateur |
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. |
|
WarnAboutClipboardRedirection |
Lecture/écriture |
Spécifie si la boîte de dialogue d’avertissement de sécurité doit inclure un avertissement sur la redirection du Presse-papiers avant de démarrer une session. |
|
WarnAboutSendingCredentials |
Lecture/écriture |
Spécifie si l’avertissement de sécurité doit inclure un avertissement concernant l’envoi d’informations d’identification au serveur distant avant de démarrer une session. |
Configuration requise
| 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_MsRdpClient5 est défini comme 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 |