Propriété IMsRdpExtendedSettings::Property

Contient une propriété nommée.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT put_Property(
  [in]          BSTR    bstrPropertyName,
  [in]          VARIANT *pValue
);

HRESULT get_Property(
  [in]          BSTR    bstrPropertyName,
  [out, retval] VARIANT *pValue
);

Valeur de la propriété

La valeur de propriété nommée.

Nom de la propriété	Type de données	Access	Peut être modifié après le démarrage de la connexion	Description
ConnectToChildSession	VT_BOOL	Lecture/écriture	Oui	Si cette propriété a la valeur True, le contrôle client se connecte à la session enfant sur l’ordinateur local au lieu d’un serveur distant. Si cette propriété a la valeur true, vous ne pouvez pas vous connecter à un serveur distant, car toutes les connexions sont redirigées vers localhost. Pour plus d’informations sur les sessions enfants, consultez Sessions enfants.
DisableCredentialsDelegation	VT_BOOL	Lecture/écriture	Non	Si la valeur est True, les informations d’identification ne sont pas envoyées au serveur distant.
EnableFrameBufferRedirection	VT_BOOL	Lecture/écriture	Non	Si la valeur est True, la redirection de mémoire tampon d’images est tentée. Pour une connexion de bouclage (le même ordinateur est à la fois client et serveur), la redirection de mémoire tampon d’images permet de partager la mémoire pour la mémoire tampon d’images entre les sessions.
EnableHardwareMode	VT_BOOL	Écriture seule	Non	Si la valeur est True, l’assistance matérielle avec le décodage graphique est tentée.
IgnoreCursors	VT_BOOL	Écriture seule	Non	Si la valeur est True, les curseurs envoyés par le serveur distant sont ignorés.
ManualClipboardSyncEnabled	VT_BOOL	Lecture/écriture	Oui	La définition de cette propriété sur True signifie que les Presse-papiers locaux et distants ne sont pas automatiquement conservés dans la synchronisation. Au lieu de cela, l’interface IMsRdpClipboard doit être utilisée pour synchroniser les formats du Presse-papiers local du Presse-papiers local vers le Presse-papiers distant du Presse-papiers distant vers le Presse-papiers local.
ZoomLevel	*VT_UI4	Lecture/écriture	Oui	Implémente la fonctionnalité Zoom à l’aide du contrôle ActiveX RDP. La fonctionnalité Zoom est disponible dans le menu Système de RDP. La propriété ZoomLevel n’a aucun effet en mode RemoteApp et en mode plein écran. IMsRdpClientAdvancedSettings::SmartSizing et ZoomLevel s’excluent mutuellement.
DisableSeamlessLanguageBar	VT_BOOL	R/W	Aucune	Si la valeur est True, les connexions RemoteApp sont rétablies dans la barre de langue héritée d’avant Windows 8, au lieu de synchroniser automatiquement la langue locale vers la session distante.
RedirectTextProcessing	VT_BOOL	W	Aucune	À compter de Windows 11 23H2, active/désactive la redirection du traitement de texte qui fournit une expérience locale semblable pour les scénarios d’entrée de texte, par exemple les IME ou les émoticônes.
HvSocketServiceId	VT_BSTR	W	Aucune	Spécifie le champ ServiceId de l’adresse du socket Hyper-V où le trafic RDP doit être envoyé.
DeviceScaleFactor	VT_UI4	R/W	Aucune	Spécifie le facteur d’échelle de l’appareil utilisé dans la session distante. Valeurs valides : 100, 140, 180
EnableLocationRedirection	VT_BOOL	R/W	Aucune	Active/désactive la redirection de l’emplacement de l’ordinateur local vers la session distante.
AudioCaptureDevice	VT_BSTR	R/W	Aucune	Spécifie l’ID d’appareil de l’appareil de capture audio pour rediriger du client vers la session à distance. Les applications peuvent utiliser le message DRV_QUERYFUNCTIONINSTANCEID pour déterminer l’ID de l’appareil de capture audio à rediriger. Vous pouvez également définir la valeur « par défaut » pour utiliser l’appareil par défaut ou « aucun » pour désactiver la capture audio. Par défaut, cette valeur est définie sur « default ».
RailMode	VT_BOOL	R	Aucune	Indique s’il s’agit d’une connexion RemoteApp. ITSRemoteProgram::RemoteProgramMode écrit dans cette propriété.
EnableRdsAadAuth	VT_BOOL	W	Aucune	Si la valeur est True, la sécurité d’authentification AAD RDS est utilisée.
RDGIsKDCProxy	VT_BOOL	W	Aucune	Si la valeur est True, indique au client d’utiliser la passerelle des services Bureau à distance (si elle est spécifiée) en tant que serveur proxy KDC.
UseURCP	VT_BOOL	R/W	Aucune	Si la valeur est True, cette propriété active le protocole de contrôle de débit universel pour les connexions Bureau à distance basées sur UDP. Actuellement, elle est désactivée par défaut. Si UDP est en cours d’utilisation, son activation est recommandée.
DesktopScaleFactor	VT_UI4	R/W	Aucune	Spécifie le facteur d’échelle de l’appareil utilisé dans la session distante. La valeur doit être comprise entre 100 et 500 (pourcentage).
RedirectedAuthentication	VT_BOOL	W	Aucune	Si la valeur est True, La protection des informations d’identification distantes est activée.
RestrictedLogon	VT_BOOL	W	Aucune	Si la valeur est True, le mode Administrateur restreint est activé.
AudioPlaybackDevice	VT_BSTR	R/W	Aucune	Spécifie l’ID d’appareil de l’appareil de lecture audio sur l’ordinateur local. Les applications peuvent utiliser le message DRV_QUERYFUNCTIONINSTANCEID pour déterminer l’ID de l’appareil de lecture audio à rediriger. Vous pouvez également définir cette option sur « par défaut » pour utiliser l’appareil par défaut ou « aucun » pour désactiver la lecture audio. Par défaut, cette valeur est définie sur « « par défaut ». "
SelectedMonitors	VT_BSTR	R/W	Aucune	Liste d’ID de moniteur, délimitée par des virgules ou par des points-virgules, pour identifier les moniteurs sélectionnés où afficher la session distante. Le premier ID de la liste sera traité comme le moniteur principal de la session distante.
WslgModeEnabled	VT_BOOL	W	Aucune	Si la valeur est True, la session est une session WSLg. Les propriétés suivantes doivent être fournies : WslgSharedMemoryPath HvSocketEnabled HvSocketServiceId Reportez-vous à la documentation de WSLg https://github.com/microsoft/wslg.
ShowSessionDiagnostics	VT_BOOL	W	Oui	L’écriture de True dans cette propriété affiche immédiatement une boîte de dialogue contenant des informations détaillées sur la session à distance. Cette propriété est censée être un mécanisme de débogage. Elle est soumise à la modification et à la suppression.
PrintingProgressMode	VT_UI4	R/W	Aucune	Valeurs possibles : 0 : boîte de dialogue de progression affichée lors de l’impression est désactivée 1 : la boîte de dialogue de progression affichée lors de l’impression contient des informations de base 2 : boîte de dialogue de progression affichée lors de l’impression contient des informations détaillées
CorrelationId	VT_BOOL	W	Aucune	Remplace la valeur retournée par IMsRdpClientNonScriptable8::CorrelationId.
RequestUseNewOutputPresenter	VT_BOOL	W	Aucune	Si la valeur est True, la session à distance est présentée à l’aide de DirectX uniquement, sans repli sur GDI. Cette propriété ne s’applique pas aux sessions d’application distantes. Remarque : cette propriété est soumise à la suppression dans les futures versions de Windows, car le mode DirectX uniquement peut devenir la seule option disponible. Il s’agit actuellement d’une fonctionnalité d’évaluation qui ne doit pas être activée dans le code de production.
GatewayCertificateLogonAuthority	VT_BSTR	W	Aucune	Cette propriété n’est plus prise en charge. Elle est soumise à la suppression dans les futures versions de Windows. N’utilisez pas cette propriété.
EnableRemoteEdgeBar	VT_BOOL	R/W	Aucune	Si la valeur est True et que la propriété ServerSupportsEdgeActions a la valeur True, des commandes supplémentaires sont affichées dans la barre d’outils de connexion de la session distante.
TSGTransportIsUsed	VT_BOOL	R	NON APPLICABLE	Si la valeur est True, une passerelle Bureau à distance est utilisée pour la session distante associée.
DiagnosticsInfo	VT_BSTR	W	Aucune	Chaîne hexadécimale représentant le champ rdpCorrelationInfo.correlationId du PDU de demande de connexion au client X.224.
EndpointFedAuth	VT_BSTR	W	Aucune	Jeton utilisé pour l’authentification RDSTLS fédérée basée sur les revendications.
AllowAxToContainerEvents	VT_BOOL	W	Aucune	Cette propriété a été ajoutée dans Windows 11 22H2. Si la valeur est False (comportement par défaut à partir de Windows 11 22H2), les combinaisons de touches Ctrl+Alt+Flèche sont envoyées à la session à distance. Si la valeur est True (comportement par défaut avant Windows 11 22H2), les combinaisons de touches Ctrl+Alt+Flèche déclenchent un événement IMsTscAxEvents::OnFocusReleased vers l’application.
ServerSupportsEdgeActions	VT_BOOL	R	NON APPLICABLE	Propriété en lecture seule pour déterminer si la session distante a la fonctionnalité RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411.
AppContainerID	VT_BSTR	W	Aucune	L’ID AppContainer transmis à IWorkspaceScriptable3::StartWorkspaceEx2 lorsque IMsRdpClientNonScriptable8::StartWorkspaceExtension est appelé. Remarque : Le panneau de configuration Connexions Bureau et RemoteApp n’est plus en développement actif. Il peut être modifié ou indisponible dans les futures versions de Windows. L’utilisation de cette API est déconseillée.
IgnoreServerGeneratedMouseMoves	VT_BOOL	R/W	Aucune	Si la valeur est True, le déplacement de la souris généré par programme dans la session distante est ignoré. Plus précisément, le PDU de mise à jour de position du pointeur n’est pas appliqué. Consultez https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c.
RDmiDiagnosticsUrl	VT_BSTR	W	Aucune	Cette propriété n’est plus prise en charge. Elle est soumise à la suppression dans les futures versions de Windows. N’utilisez pas cette propriété.
EnableVailMonitorConfig	VT_BOOL	R/W	Aucune	Si la valeur est True, les informations du moniteur étendu (par exemple les EDID) sont envoyées à la session à distance lors de la synchronisation des configurations d’affichage.
ID de l'espace de travail	VT_BSTR	W	Aucune	Identificateur unique de la connexion dans Les connexions RemoteApp et Bureau auxquelles la session à distance appartient.
ShowConnectionInformation	VT_BOOL	W	Oui	L’écriture de True dans cette propriété affiche la boîte de dialogue Informations de connexion.
WslgSharedMemoryPath	VT_BSTR	W	Aucune	Chemin d’accès à l’objet de session mémoire pour partager la mémoire tampon graphique avec la machine virtuelle WSLg.
HiDefRemoteAppContainerGUID	VT_BSTR	W	Aucune	GUID associé à la machine virtuelle en cours d’exécution qui héberge l’application distante. L’écriture de cette propriété entraîne une amélioration des performances pour les applications distantes s’exécutant dans une machine virtuelle locale en raison du partage de mémoire.
KDCProxyName	VT_BSTR	W	Aucune	« Spécifie le nom de domaine complet d’un serveur proxy du Centre de distribution de clés (KDC). Le proxy KDC permet au client RDP d’utiliser le protocole d’authentification Kerberos lorsqu’il ne peut pas accéder directement à un KDC.  Exemple de valeur de propriété : « kdc.contoso.com ». Pour plus d’informations, consultez : Configurer un proxy du centre de distribution de clés Kerberos, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38
DisableTouchRemoting	VT_BOOL	R/W	Aucune	Si la valeur est True, les mouvements sur les écrans tactiles multiples ne sont pas envoyés au serveur distant. Par défaut, cette valeur est définie sur False.
HvSocketEnabled	VT_BOOL	W	Aucune	Si la valeur est True, le nom du serveur distant, s’il s’agit d’un GUID, est interprété comme le champ VmId de l’adresse du socket Hyper-V où le trafic RDP doit être envoyé. Par défaut, cette valeur est définie sur False. Pour plus d’informations sur les adresses du socket Hyper-V, consultez Lier à un socket Hyper-V.
MultipenRemotingSupported	VT_BOOL	W	Aucune	Si a valeur est lTrue, l’injection simultanée d’entrées issues de jusqu’à quatre appareils de stylet est prise en charge dans la session à distance. Par défaut, cette valeur est définie sur False.
ShowGatewayInformation	VT_BOOL	W	Oui	L’écriture de True dans cette propriété affiche une boîte de dialogue montrant des informations sur la passerelle Bureau à distance. Windows 11 22H2 et versions ultérieures : cette propriété n’est plus prise en charge et a été remplacée par la propriété ShowConnectionInformation.

Spécifications

Condition requise	Value
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Bibliothèque de types	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient7NotSafeForScripting est défini comme 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting est défini comme A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting est défini comme 8B918B82-7985-4C24-89DF-C33AD2BBFBCD
IID	IID_IMsRdpExtendedSettings est défini comme 302D8188-0052-4807-806A-362B628F9AC5

Voir aussi

IMsRdpExtendedSettings