MsRdpClient10NotSafeForScripting, classe
Microsoft RDP Client Control - version 11
Cette classe implémente les interfaces suivantes.
- IMsRdpClient10
- IMsRdpClient9
- IMsRdpClient8
- IMsRdpClient7
- IMsRdpClient6
- IMsRdpClient5
- IMsRdpClient4
- IMsRdpClient3
- IMsRdpClient2
- IMsRdpClient
- IMsTscAx
- IDispatch
- IMsTscAxEvents
- IMsTscNonScriptable
- IMsRdpClientNonScriptable
- IMsRdpClientNonScriptable2
- IMsRdpClientNonScriptable3
- IMsRdpClientNonScriptable4
- IMsRdpClientNonScriptable5
- IMsRdpPreferredRedirectionInfo
- IMsRdpExtendedSettings
MsRdpClient10NotSafeForScripting a les types de membres suivants :
Méthodes
La classe MsRdpClient10NotSafeForScripting possède ces méthodes.
| Méthode | Description |
|---|---|
| attachEvent | Joint un événement. |
| 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é. |
| detachEvent | Détache un événement. |
| 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 status pour le code status spécifié. |
| 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. |
| Reconnexion | Se reconnecte à la session à distance avec la nouvelle largeur et la hauteur du bureau. |
| 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 . |
| SendRemoteAction | Provoque l’exécution d’une action dans la session distante. |
| SetVirtualChannelOptions | Définit les options de canal virtuel pour le contrôle client. |
| SyncSessionDisplaySettings | Synchronise les paramètres d’affichage de session. |
| UpdateSessionDisplaySettings | Mises à jour paramètres d’affichage de session. |
Propriétés
La classe MsRdpClient10NotSafeForScripting 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. |
|
AdvancedSettings3 |
Lecture seule |
Pointeur vers l’interface IMsRdpClientAdvancedSettings2 , utilisé pour définir les paramètres avancés pour le contrôle client. |
|
AdvancedSettings4 |
Lecture seule |
Pointeur vers l’interface IMsRdpClientAdvancedSettings3 , utilisé pour définir les paramètres avancés pour le contrôle client. |
|
AdvancedSettings5 |
Lecture seule |
Pointeur d’interface IMsRdpClientAdvancedSettings4 . |
|
AdvancedSettings6 |
Lecture seule |
Interface vers IMsRdpClientAdvancedSettings5. |
|
AdvancedSettings7 |
Lecture seule |
Interface vers IMsRdpClientAdvancedSettings6. |
|
AdvancedSettings8 |
Lecture seule |
Objet qui prend en charge l’interface IMsRdpClientAdvancedSettings7 . |
|
AdvancedSettings9 |
Lecture seule |
Interface IMsRdpClientAdvancedSettings8 qui représente l’objet settings. |
|
AllowCredentialSaving |
Lecture/écriture |
Spécifie si la boîte de dialogue des informations d’identification affiche une zone de case activée pour permettre l’enregistrement des informations d’identification. |
|
AllowPromptingForCredentials |
Lecture/écriture |
Spécifie si le contrôle 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 |
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. |
|
ConnectedStatusText |
Lecture/écriture |
Texte affiché dans la zone cliente du contrôle alors que le contrôle est à 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. |
|
DésactiverConnectionBar |
Écriture seule |
Spécifie si le contrôle ActiveX Bureau à distance doit désactiver la barre de connexion. |
|
DisableRemoteAppCapsCheck |
Lecture/écriture |
Spécifie si le contrôle ActiveX Bureau à distance ne doit pas case activée le serveur pour les fonctionnalités RemoteApp. |
|
DisconnectedText |
Lecture/écriture |
Texte qui apparaît centré dans le contrôle avant la fin d’une connexion. |
|
Domaine |
Lecture/écriture |
Domaine sur lequel 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. |
|
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 d’accès Web Bureau à distance. |
|
MarkRdpSettingsSecure |
Lecture/écriture |
Spécifie si les paramètres RDP sont marqués comme sécurisés. |
|
MsRdpClientShell |
Lecture seule |
Paramètres du 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. |
|
PromptForCredsOnClient |
Lecture/écriture |
Spécifie si le contrôle client affiche une boîte de dialogue qui demande des informations d’identification. |
|
Propriété |
Lecture/écriture |
Contient une propriété nommée. |
|
PublisherCertificateChain |
Lecture/écriture |
Spécifie la chaîne de certificats d’éditeur. La chaîne est stockée dans une variante 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 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. |
|
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 distants. |
|
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 . |
|
RemoteProgram3 |
Lecture seule |
Objet qui prend en charge l’interface ITSRemoteProgram3 . |
|
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. |
|
SecuredSettings3 |
Lecture seule |
Objet qui prend en charge l’interface IMsRdpClientSecuredSettings2 . |
|
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. |
|
TransportSettings2 |
Lecture seule |
Interface vers IMsRdpClientTransportSettings2. |
|
TransportSettings3 |
Lecture seule |
Objet qui prend en charge l’interface IMsRdpClientTransportSettings3 . |
|
TransportSettings4 |
Lecture seule |
Objet qui prend en charge l’interface IMsRdpClientTransportSettings4 . |
|
TrustedZoneSite |
Lecture/écriture |
Spécifie si le site web à partir duquel l’utilisateur a lancé la connexion figure dans la liste des sites approuvés de l’ordinateur 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. |
|
UseMultimon |
Lecture/écriture |
Spécifie si le contrôle ActiveX Bureau à distance doit utiliser plusieurs moniteurs. |
|
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 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. |
|
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 d’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 de démarrer une session. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 10 (applications de bureau uniquement) |
| Serveur minimal pris en charge |
Windows Server 2016 |
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient10NotSafeForScripting est défini comme A0C63C30-F08D-4AB4-907C-34905D770C7D |