IMsRdpExtendedSettings ::P roperty, propriété
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 propriété
Valeur de propriété nommée.
| Nom de la propriété | Type de données | Accès | Peut être modifié après le démarrage de la connexion | Description |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Lecture/écriture | Oui | La définition de cette propriété sur True entraîne la connexion du contrôle client à la session enfant sur l’ordinateur local au lieu d’un serveur distant. Si cette propriété est définie sur 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 True, les informations d’identification ne sont pas envoyées au serveur distant. |
| EnableFrameBufferRedirection | VT_BOOL | Lecture/écriture | Non | Si 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 mémoire pour la mémoire tampon d’images entre les sessions. |
| EnableHardwareMode | VT_BOOL | Écrire uniquement | Non | Si True, le décodage graphique est tenté. |
| IgnoreCursors | VT_BOOL | Écrire uniquement | Non | Si 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 |
| 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 | Non | Si True, cela entraîne la restauration des connexions RemoteApp à la barre de langue héritée avant Windows 8, au lieu de synchroniser automatiquement la langue locale à la session distante. |
| RedirectTextProcessing | VT_BOOL | W | Non | À 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, IME, émoticônes. |
| HvSocketServiceId | VT_BSTR | W | Non | Spécifie le champ ServiceId de l’adresse du socket Hyper-Voù le trafic RDP doit être envoyé. |
| DeviceScaleFactor | VT_UI4 | R/W | Non | Spécifie le facteur d’échelle d’appareil utilisé dans la session à distance. Valeurs valides : 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Non | Active/désactive la redirection de l’emplacement de l’ordinateur local vers la session distante. |
| AudioCaptureDevice | VT_BSTR | R/W | Non | Spécifie l’ID d’appareil de l’appareil de capture audio à 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 | Non | Indique s’il s’agit d’une connexion RemoteApp. ITSRemoteProgram ::RemoteProgramMode écrit dans cette propriété. |
| EnableRdsAadAuth | VT_BOOL | W | Non | Si True, de sécurité d’authentification RDS AAD est utilisée. |
| RDGIsKDCProxy | VT_BOOL | W | Non | Si True, indique au client d’utiliser la passerelle Bureau à distance (si spécifiée) comme serveur proxy KDC. |
| UseURCP | VT_BOOL | R/W | Non | Si 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. L’activation si UDP est en cours d’utilisation est recommandée. |
| DesktopScaleFactor | VT_UI4 | R/W | Non | Spécifie le facteur d’échelle d’appareil utilisé dans la session à distance. La valeur doit être comprise entre 100 et 500 (pourcentage). |
| RedirectedAuthentication | VT_BOOL | W | Non | Si True, Remote Credential Guard est activé. |
| RestrictedLogon | VT_BOOL | W | Non | Si True, mode Administrateur restreint est activé. |
| AudioPlaybackDevice | VT_BSTR | R/W | Non | 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 | Non | Liste délimitée par des virgules ou délimitées par des points-virgules d’ID de moniteur 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 | Non | Si 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 destinée à être un mécanisme de débogage. Il est soumis à la modification et à la suppression. |
| PrintingProgressMode | VT_UI4 | R/W | Non | Valeurs possibles :
|
| CorrelationId | VT_BOOL | W | Non | Remplace la valeur retournée par IMsRdpClientNonScriptable8 ::CorrelationId. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Non | Si True, la session à distance est présentée à l’aide de DirectX uniquement sans secours 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é en préversion qui ne doit pas être activée dans le code de production. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Non | Cette propriété n’est plus prise en charge. Il est soumis à la suppression dans les futures versions de Windows. N’utilisez pas cette propriété. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Non | Si |
| TSGTransportIsUsed | VT_BOOL | R | N/A | Si True, une passerelle Bureau à distance est utilisée pour la session distante associée. |
| DiagnosticsInfo | VT_BSTR | W | Non | Chaîne hexadécimale représentant le champ |
| EndpointFedAuth | VT_BSTR | W | Non | Jeton utilisé pour l’authentification fédérée basée sur les revendications l’authentification RDSTLS. |
| AllowAxToContainerEvents | VT_BOOL | W | Non | Cette propriété a été ajoutée dans Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | N/A | 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 | Non | L’ID AppContainer passé à IWorkspaceScriptable3 ::StartWorkspaceEx2 lorsque IMsRdpClientNonScriptable8 ::StartWorkspaceExtension est appelée. 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 | Non | Si True, le déplacement de la souris généré par programme dans la session à distance est ignoré. Plus précisément, le PDU de mise à jour de position du pointeur n’est pas appliqué. Voir https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Non | Cette propriété n’est plus prise en charge. Il est soumis à la suppression dans les futures versions de Windows. N’utilisez pas cette propriété. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Non | Si True, les informations du moniteur étendu (par exemple, EDID) sont envoyées à la session à distance lors de la synchronisation des configurations d’affichage. |
| ID de l’espace de travail | VT_BSTR | W | Non | Identificateur unique de la connexion dans RemoteApp and Desktop Connections auquel appartient la session distante. |
| ShowConnectionInformation | VT_BOOL | W | Oui | L’écriture True dans cette propriété affiche la boîte de dialogue Informations de connexion. |
| WslgSharedMemoryPath | VT_BSTR | W | Non | 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 | Non | 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 | Non | « 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 de 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 | Non | Si 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 | Non | Si 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, reportez-vous à Lier à unde socket Hyper-V. |
| MultipenRemotingSupported | VT_BOOL | W | Non | Si True, l’injection simultanée d’entrée à partir de 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. |
| DisableAutoReconnectComponent | VT_BOOL | W | Non | Si True, la connexion au serveur ne sera pas déconnectée et reconnectée automatiquement lorsque la configuration réseau est modifiée. Par défaut, cette valeur est définie sur False. |
| RedirectUsbDrive | VT_UI4 | R/W | Non | Introduit dans Windows 11 version 24H2. Lorsqu’il n’est pas défini ou défini sur 0, le lecteur USB est redirigé comme direction du lecteur. Lorsque la valeur est définie sur 1, tous les lecteurs USB sont redirigés automatiquement en tant qu’appareils USB. Lorsque la valeur est définie sur 2, les lecteurs USB sont répertoriés en tant qu’appareils USB, les utilisateurs peuvent choisir de les rediriger via la redirection USB à partir de l’interface utilisateur (boîte de dialogue d’appareil dans la barre de connexion) ou de l’entrée de fichier RDP « UsbDevicesToRedirect ». |
| protocoles de sécurité autorisés | VT_BSTR | W | Non | Introduit dans Windows 11 version 24H2. Cette propriété est utilisée pour restreindre la liste des protocoles de sécurité que le client peut négocier. La liste réelle des protocoles négociés est déterminée par d’autres paramètres de configuration et le scénario de connexion, et peut être inférieure à la liste spécifiée dans cette propriété. La valeur doit contenir la liste des noms de protocole séparés par « ; » ou la valeur peut être définie sur «», ce qui signifie que tous les protocoles normalement négociés sont autorisés. Les noms de protocole pris en charge sont : « TLS », « CredSSP », « RDSTLS » et « Authentification RDS AAD » La valeur par défaut est «». |
| AllowRelativeMouseMode | VT_BOOL | R/W | Non | Introduit dans Windows 11 version 24H2. Si la valeur est True, les mouvements de la souris sont représentés par rapport à la position actuelle de la souris. |
| RemoteAppMouseMoveInject | VT_BOOL | W | Non | Introduit dans Windows 11 version 24H2. L’écriture de true dans cette propriété force l’injection d’un déplacement de souris lorsque le curseur quitte une fenêtre RemoteApp. Il s’agit d’une solution de contournement pour un bogue d’info-bulle. |
Exigences
| Exigence | Valeur |
|---|---|
| Client minimum pris en charge |
Windows 8 |
| Serveur minimum 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 |