MsRdpClient7NotSafeForScripting, classe
«Contrôle client Microsoft RDP-version 8
Cette classe implémente les interfaces suivantes.
- IMsRdpClient7
- IMsRdpClient6
- IMsRdpClient5
- IMsRdpClient4
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
- IMsRdpClientNonScriptable2
- IMsRdpClientNonScriptable3
- IMsRdpClientNonScriptable4
- IMsRdpClientNonScriptable5
- IMsRdpPreferredRedirectionInfo
- IMsRdpExtendedSettings
MsRdpClient7NotSafeForScripting possède les types de membres suivants :
Méthodes
La classe MsRdpClient7NotSafeForScripting possède ces méthodes.
| Méthode | Description |
|---|---|
| Connecter | Établit 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. |
| GetStatusText | Récupère le texte d’État pour le code d’état spécifié. |
| GetVirtualChannelOptions | Récupère les options définies pour un canal virtuel. |
| NotifyRedirectDeviceChange | notifie le module de redirection de l’appareil du contrôle de Bureau à distance ActiveX qu’une modification de l’appareil s’est produite sur le système. Cette méthode passe les notifications WM _ DEVICECHANGE au contrôle. |
| OnAuthenticationWarningDismissed | appelé après qu’un contrôle ActiveX affiche une boîte de dialogue d’authentification (par exemple, la boîte de dialogue erreur de certificat). |
| OnAuthenticationWarningDisplayed | appelé avant qu’un contrôle ActiveX affiche une boîte de dialogue d’authentification (par exemple, la boîte de dialogue erreur de certificat). |
| OnAutoReconnected | Appelé lorsque le contrôle client se reconnecte automatiquement à une session à distance. |
| OnAutoReconnecting | Appelée lorsqu’un client se trouve dans le processus de reconnexion automatique d’une session à un serveur hôte de session Bureau à distance. |
| OnAutoReconnecting2 | Appelée lorsqu’un client se trouve dans le processus de reconnexion automatique d’une session à un serveur hôte de session Bureau à distance. |
| OnChannelReceivedData | Appelé lorsque le client reçoit des données sur un canal virtuel scriptable. |
| OnConfirmClose | Appelée 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 :: connecter. |
| OnConnectionBarPullDown | Appelé lorsque l’utilisateur a fait glisser vers le dessous de la barre de connexion. |
| OnDevicesButtonPressed | Appelé lorsque le bouton appareils de 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é quand l’utilisateur appuie sur la combinaison de touches de raccourci du mode plein écran (Ctrl + Alt + Attn). |
| OnFatalError | Appelé lorsque le contrôle client rencontre une erreur irrécupérable. |
| OnFocusReleased | Appelé lorsque la combinaison de touches de focus de mise en sortie est enfoncée. Par exemple, cet événement est appelé quand l’utilisateur appuie sur la touche CTRL + ALT + gauche ou sur la combinaison de touches CTRL + ALT + flèche droite. |
| OnIdleTimeoutNotification | Appelé quand 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é quand l’utilisateur appuie sur la combinaison de touches de raccourci du mode plein écran (Ctrl + Alt + Attn). |
| OnLoginComplete | appelé lorsque le contrôle client a réussi à se connecter à un serveur hôte de Session bureau à distance, en suivant l’affichage de la boîte de dialogue Windows Logon. |
| OnLogonError | Appelée 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 l’état du réseau a changé. |
| OnReceivedTSPublicKey | Appelé pendant la séquence de connexion lorsque le client récupère la clé publique du serveur. Cet événement est appelé uniquement si la propriété NotifyTSPublicKey a la _ valeur 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 est affiché. |
| OnRemoteProgramResult | Appelée 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 que l’application conteneur réduit. |
| OnRequestGoFullScreen | Appelée lorsque le client demande à basculer 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ée lorsque le client demande à conserver 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ée 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 approprié 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, c’est-à-dire les données de clavier des véritables clés physiques. |
| SendOnVirtualChannel | Envoie des données au serveur hôte de session Bureau à distance via un canal virtuel qui a été 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 MsRdpClient7NotSafeForScripting possède les propriétés suivantes.
| 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 des paramètres avancés pour le contrôle client. |
| AdvancedSettings3 |
Lecture seule |
Pointeur vers l’interface IMsRdpClientAdvancedSettings2 , utilisé pour définir des paramètres avancés pour le contrôle client. |
| AdvancedSettings4 |
Lecture seule |
Pointeur vers l’interface IMsRdpClientAdvancedSettings3 , utilisé pour définir des paramètres avancés pour le contrôle client. |
| AdvancedSettings5 |
Lecture seule |
Pointeur d’interface IMsRdpClientAdvancedSettings4 . |
| AdvancedSettings6 |
Lecture seule |
Interface à IMsRdpClientAdvancedSettings5. |
| AdvancedSettings7 |
Lecture seule |
Interface à IMsRdpClientAdvancedSettings6. |
| AdvancedSettings8 |
Lecture seule |
Objet qui prend en charge l’interface IMsRdpClientAdvancedSettings7 . |
| AllowCredentialSaving |
Lecture/écriture |
Spécifie si la boîte de dialogue informations d’identification affiche une case à cocher pour activer l’enregistrement des informations d’identification. |
| AllowPromptingForCredentials |
Lecture/écriture |
spécifie si le contrôle de ActiveX Bureau à distance peut inviter l’utilisateur à fournir des informations d’identification. |
| 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 |
Bureau à distance ActiveX mot de passe de contrôle, au format texte en clair. |
| La |
Lecture/écriture |
Profondeur de couleur du contrôle actuel. |
| Correctement |
Lecture seule |
État de connexion du contrôle actuel. |
| ConnectedStatusText |
Lecture/écriture |
Texte affiché dans la zone cliente du contrôle pendant 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, en pixels, du contrôle actif sur le Bureau à distance initial. |
| DeviceCollection |
Lecture seule |
Collection des périphériques PnP disponibles pour la redirection. |
| DisableConnectionBar |
Écriture seule |
spécifie si le contrôle de ActiveX Bureau à distance doit désactiver la barre de connexion. |
| DisableRemoteAppCapsCheck |
Lecture/écriture |
spécifie si le contrôle de ActiveX Bureau à distance ne doit pas vérifier les fonctionnalités RemoteApp du serveur. |
| DisconnectedText |
Lecture/écriture |
Texte qui apparaît centré dans le contrôle avant qu’une connexion ne soit terminée. |
| Domain |
Lecture/écriture |
Domaine sur lequel l’utilisateur actuel ouvre une session. |
| 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. |
| Large |
Lecture/écriture |
Indique si le contrôle est en mode plein écran. |
| FullScreenTitle |
Écriture seule |
Titre de la fenêtre qui s’affiche lorsque le contrôle est en mode plein écran. |
| GetRemoteMonitorsBoundingBox |
Lecture seule |
Spécifie le rectangle englobant du moniteur distant. |
| HorizontalScrollBarVisible |
Lecture seule |
Indique si le contrôle a affiché une barre de défilement horizontale. |
| LaunchedViaClientShellInterface |
Lecture/écriture |
Spécifie si l’utilisateur a lancé le contrôle client à l’aide de l’interface de Accès web des services Bureau à distance. |
| MarkRdpSettingsSecure |
Lecture/écriture |
Spécifie si les paramètres RDP sont marqués comme sécurisés. |
| MsRdpClientShell |
Lecture seule |
Paramètres client pour le lanceur du portail Web. |
| NegotiateSecurityLayer |
Lecture/écriture |
Spécifie si le paramètre NegotiateSecurityLayer est pris en charge pour cette connexion.[!Note] |
| 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 demander les informations d’identification doit s’afficher. |
| PromptForCredsOnClient |
Lecture/écriture |
Spécifie si le contrôle client affiche une boîte de dialogue qui vous invite à entrer des informations d’identification. |
| Propriété |
Lecture/écriture |
Contient une propriété nommée. |
| PublisherCertificateChain |
Lecture/écriture |
Spécifie la chaîne du certificat de l’éditeur. La chaîne est stockée dans un variant de type VT_BYREF qui contient un pointeur vers une structure CERT_CHAIN_CONTEXT . |
| RedirectDynamicDevices |
Lecture/écriture |
Spécifie si les appareils PnP attachés de manière dynamique et qui sont énumérés dans une session sont disponibles pour la redirection. |
| RedirectDynamicDrives |
Lecture/écriture |
Spécifie si les lecteurs PnP attachés de manière dynamique et qui sont énumérés dans une session sont disponibles pour la redirection. |
| RedirectionWarningType |
Lecture/écriture |
Contrôle la présence et l’apparence de la boîte de dialogue de redirection. |
| RemoteMonitorCount |
Lecture seule |
Spécifie le nombre de moniteurs à distance. |
| RemoteMonitorLayoutMatchesLocal |
Lecture seule |
Spécifie si la disposition du moniteur distant est identique à la disposition du moniteur local. |
| RemoteProgram |
Lecture seule |
Paramètre RemoteApp du client. |
| RemoteProgram2 |
Lecture seule |
Objet qui prend en charge l’interface ITSRemoteProgram2 . |
| 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. |
| SecuredSettings3 |
Lecture seule |
Objet qui prend en charge l’interface IMsRdpClientSecuredSettings2 . |
| SecuredSettingsEnabled |
Lecture seule |
Indique si l’interface IMsTscSecuredSettings est disponible. |
| Serveurs |
Lecture/écriture |
Nom du serveur auquel le contrôle actuel est connecté. |
| ShowRedirectionWarningDialog |
Lecture/écriture |
Spécifie si la boîte de dialogue Avertissement de sécurité de redirection doit s’afficher avant le démarrage d’une session. |
| StartConnected |
Lecture/écriture |
Indique si le contrôle établira la connexion au serveur hôte de session Bureau à distance dès le démarrage. |
| TransportSettings |
Lecture seule |
Paramètre de la passerelle des services Bureau à distance du client. |
| TransportSettings2 |
Lecture seule |
Interface à IMsRdpClientTransportSettings2. |
| TransportSettings3 |
Lecture seule |
Objet qui prend en charge l’interface IMsRdpClientTransportSettings3 . |
| TrustedZoneSite |
Lecture/écriture |
Spécifie si le site Web à partir duquel l’utilisateur a lancé la connexion se trouve dans la liste des sites de confiance de l’ordinateur client. |
| UIParentWindowHandle |
Lecture/écriture |
Handle de fenêtre qui doit être la fenêtre parente pour le contrôle. Cela permet aux fenêtres affichées par le contrôle d’être correctement modales par rapport à toutes les fenêtres affichées par l’application parente. |
| UseMultimon |
Lecture/écriture |
spécifie si le contrôle de ActiveX Bureau à distance doit utiliser plusieurs analyses. |
| UseRedirectionServerName |
Lecture/écriture |
Indique s’il faut utiliser le nom du serveur de redirection. |
| Nom d’utilisateur |
Lecture/écriture |
Informations d’identification d’ouverture de session de 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. |
| WarnAboutDirectXRedirection |
Lecture/écriture |
Cette propriété n'est pas utilisée. |
| WarnAboutPrinterRedirection |
Lecture/écriture |
Spécifie si la boîte de dialogue de redirection affiche un message sur la redirection de l’imprimante 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 le démarrage d’une session. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 8 |
| Serveur minimal pris en charge |
Windows Server 2012 |
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
Le CLSID _ MsRdpClient7NotSafeForScripting est défini en tant que 54D38BF7-B1EF-4479-9674-1BD6EA465258 |