MsRdpClient12NotSafeForScripting, classe

Article
10/02/2023

Microsoft RDP Client Control - version 13

Cette classe implémente les interfaces suivantes.

MsRdpClient12NotSafeForScripting a les types de membres suivants :

Méthodes
Propriétés

Méthodes

La classe MsRdpClient12NotSafeForScripting 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 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 ActiveX Bureau à distance qu’un changement d’appareil s’est produit sur le système. Cette méthode transmet WM_DEVICECHANGE notifications 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 d’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 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 cours de reconnexion automatique d’une session avec un serveur hôte de session Bureau à distance.
OnAutoReconnecting2	Appelé lorsqu’un client est en cours de reconnexion automatique d’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 fait glisser vers le bas dans la barre de connexion.
OnDevicesButtonPressed	Appelé lorsque le bouton appareils dans la barre de connexion a été appuyé.
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+ARRÊT).
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 production est enfoncée. Par exemple, cet événement est appelé lorsque l’utilisateur appuie sur la combinaison Ctrl+Alt+Gauche ou Ctrl+Alt+Flèche droite.
OnIdleTimeoutNotification	Appelée 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+ARRÊT).
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 du serveur. Cet événement est appelé uniquement 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 s’affiche.
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ée lorsque le client demande à passer en mode plein écran et que la méthode IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen est appelée pour affecter à la propriété ContainerHandledFullScreen 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 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 .
SendRemoteAction	Provoque l’exécution d’une action dans la session à distance.
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.
SendLocation2D	Envoie une valeur de latitude et de longitude au serveur afin que l’emplacement géographique du client puisse être reflété dans la session à distance.
SendLocation3D	Envoie une valeur de latitude, de longitude et d’altitude au serveur afin que l’emplacement géographique du client puisse être reflété dans la session à distance.
DisableDpiCursorScalingForProcess	Désactive la mise à l’échelle locale du curseur de la souris reçu du serveur, en veillant à ce que la forme du curseur soit affichée correctement sans modification.
StartWorkspaceExtension	Coordonne la session à distance du client avec le panneau de configuration RemoteApp and Desktop Connections.

Propriétés

La classe MsRdpClient12NotSafeForScripting 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.
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 informations d’identification affiche une zone de case activée pour activer 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	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.
DisableConnectionBar	É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 l’arrêt d’une connexion.
Domain	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.
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 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 invite à entrer des informations d’identification.
Propriété	Lecture/écriture	Contient une propriété nommée.
PublisherCertificateChain	Lecture/écriture	Spécifie la chaîne de certificats de l’é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.
CameraRedirConfigCollection	Lecture seule	Obtient la collection de caméras (et les configurations associées) disponibles pour la redirection.
Presse-papiers	Lecture seule	Obtient le contrôleur du Presse-papiers utilisé pour synchroniser les Presse-papiers locaux et distants si la synchronisation manuelle du Presse-papiers est activée.
Correlationid	Lecture seule	Obtient un GUID identifiant de manière unique la session à distance du client.
SupportsWorkspaceReconnect	Écriture seule	Informe le contrôle ActiveX Bureau à distance que la session à distance du client fait partie d’une connexion dans le panneau de configuration RemoteApp and Desktop Connections qui prend en charge la reconnexion.

Spécifications

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	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient12NotSafeForScripting est défini comme 3F859AA3-C2D4-4FAA-B0E4-FD0C9C4E5E3A

Voir aussi

Classes de contrôle ActiveX Bureau à distance