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 :
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 :
|
| 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.
|
| 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_V1 https://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 |
|
| 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 |