Interface IMsRdpClient9
Fournit les méthodes et propriétés nécessaires pour configurer et utiliser le contrôle client. Dérive de l’interface IMsRdpClient8 .
Membres
L’interface IMsRdpClient9 hérite d’IMsRdpClient8. IMsRdpClient9 a également les types de membres suivants :
Méthodes
L’interface IMsRdpClient9 a ces méthodes.
| Méthode | Description |
|---|---|
| attachEvent | Joint un événement. |
| Connecter | Initie 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é. |
| detachEvent | Détache un événement. |
| Déconnecter | Déconnecte la connexion active. |
| GetErrorDescription | Récupère la description de l’erreur pour les événements de déconnexion de session. |
| GetStatusText | Récupère le texte status pour le code status spécifié. |
| GetVirtualChannelOptions | Récupère les options définies pour un canal virtuel. |
| Reconnexion | Se reconnecte à la session à distance avec la nouvelle largeur et la hauteur du bureau. |
| RequestClose | Demande un arrêt normal du contrôle ActiveX bureau à distance. |
| 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 CreateVirtualChannels . |
| SendRemoteAction | Provoque l’exécution d’une action dans la session à distance. |
| SetVirtualChannelOptions | Définit les options de canal virtuel pour le contrôle ActiveX Bureau à distance. |
| SyncSessionDisplaySettings | Synchronise les paramètres d’affichage de session. |
| UpdateSessionDisplaySettings | Mises à jour paramètres d’affichage de session. |
Propriétés
L’interface IMsRdpClient9 a ces propriétés.
| Propriété | Type d’accès | Description |
|---|---|---|
|
AdvancedSettings |
Lecture seule |
Récupère un pointeur d’interface IMsTscAdvancedSettings . |
|
AdvancedSettings2 |
Lecture seule |
Récupère un pointeur vers l’interface IMsRdpClientAdvancedSettings . L’interface peut être utilisée pour définir des paramètres avancés pour le contrôle client. |
|
AdvancedSettings3 |
Lecture seule |
Récupère un pointeur vers l’interface IMsRdpClientAdvancedSettings2 . L’interface peut être utilisée pour définir des paramètres avancés pour le contrôle client. |
|
AdvancedSettings4 |
Lecture seule |
Récupère un pointeur vers l’interface IMsRdpClientAdvancedSettings3 . |
|
AdvancedSettings5 |
Lecture seule |
Récupère un pointeur vers une interface IMsRdpClientAdvancedSettings4 . |
|
AdvancedSettings6 |
Lecture seule |
Récupère l’interface IMsRdpClientAdvancedSettings5 . |
|
AdvancedSettings7 |
Lecture seule |
Récupère l’interface IMsRdpClientAdvancedSettings6 . |
|
AdvancedSettings8 |
Lecture seule |
Récupère un objet qui prend en charge l’interface IMsRdpClientAdvancedSettings7 . |
|
AdvancedSettings9 |
Lecture seule |
Contient un objet qui prend en charge l’interface IMsRdpClientAdvancedSettings8 . |
|
CipherStrength |
Lecture seule |
Récupère la puissance de chiffrement maximale du contrôle actuel. |
|
ColorDepth |
Lecture/écriture |
Profondeur de couleur (en bits par pixel) pour la connexion du contrôle. |
|
Connecté |
Lecture seule |
Récupère l’état de connexion du contrôle actuel. |
|
ConnectedStatusText |
Lecture/écriture |
Contient le texte affiché dans la zone cliente du contrôle alors que le contrôle est à l’état connecté. |
|
ConnectingText |
Lecture/écriture |
Spécifie le texte qui apparaît centré dans le contrôle pendant la connexion du contrôle. |
|
DesktopHeight |
Lecture/écriture |
Spécifie la hauteur du contrôle actuel, en pixels, sur le Bureau à distance initial. |
|
DesktopWidth |
Lecture/écriture |
Spécifie la largeur du contrôle actuel, en pixels, sur le Bureau à distance initial. |
|
DisconnectedText |
Lecture/écriture |
Spécifie le texte qui apparaît centré dans le contrôle avant l’arrêt d’une connexion. |
|
Domain |
Lecture/écriture |
Spécifie le domaine sur lequel l’utilisateur actuel se connecte. |
|
ExtendedDisconnectReason |
Lecture seule |
Contient des informations étendues sur la raison de la déconnexion du contrôle. |
|
Fullscreen |
Lecture/écriture |
Détermine si le contrôle client est en mode plein écran. |
|
FullScreenTitle |
Écriture seule |
Spécifie le 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 |
Récupère l’interface de paramètre client pouvant faire l’objet d’un script IMsRdpClientShell. |
|
RemoteProgram |
Lecture seule |
Récupère un objet qui prend en charge l’interface ITSRemoteProgram . |
|
RemoteProgram2 |
Lecture seule |
Récupère un objet qui prend en charge l’interface ITSRemoteProgram2 . |
|
SecuredSettings |
Lecture seule |
Récupère un pointeur d’interface IMsTscSecuredSettings . |
|
SecuredSettings2 |
Lecture seule |
Récupère un pointeur vers l’interface IMsRdpClientSecuredSettings . Cette interface peut être utilisée pour définir des paramètres sécurisés pour le contrôle client. |
|
SecuredSettings3 |
Lecture seule |
Récupère un objet qui prend en charge l’interface IMsRdpClientSecuredSettings2 . |
|
SecuredSettingsEnabled |
Lecture seule |
Indique si l’interface IMsTscSecuredSettings est disponible. Autrement dit, si la page web contenant le contrôle se trouve actuellement dans l’une des zones de sécurité d’URL Explorer Internet autorisées. |
|
Serveur |
Lecture/écriture |
Spécifie le 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. |
|
TransportSettings |
Lecture seule |
Récupère ce qui a été transmis via un script à l’interface IMsRdpClientTransportSettings . |
|
TransportSettings2 |
Lecture seule |
Récupère l’interface IMsRdpClientTransportSettings2 . |
|
TransportSettings3 |
Lecture seule |
Récupère un objet qui prend en charge l’interface IMsRdpClientTransportSettings3 . |
|
TransportSettings4 |
Lecture seule |
Récupère un objet qui prend en charge l’interface IMsRdpClientTransportSettings4 . |
|
UserName |
Lecture/écriture |
Spécifie les informations d’identification d’ouverture de session du nom d’utilisateur. |
|
Version |
Lecture seule |
Spécifie le numéro de version du contrôle actuel. |
|
VerticalScrollBarVisible |
Lecture seule |
Indique si le contrôle affiche une barre de défilement verticale. |
Notes
L’interface IMsRdpClient9 a été étendue par les interfaces suivantes, chaque nouvelle interface héritant de toutes les méthodes et propriétés des interfaces précédentes :
Pour plus d’informations sur la connexion Web Bureau à distance, consultez Configuration requise pour la connexion Web Bureau à distance.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 8.1 |
| Serveur minimal pris en charge |
Windows Server 2012 R2 |
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient10 est défini comme C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting est défini comme A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient9 est défini comme 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting est défini comme 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpClient9 est défini comme 28904001-04B6-436C-A55B-0AF1A0883DC9 |