IMsRdpExtendedSettings::P roperty-Eigenschaft
Enthält eine benannte Eigenschaft.
Diese Eigenschaft ist Lese-/Schreibzugriff.
Syntax
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Eigenschaftswert
Der benannte Eigenschaftswert.
| Eigenschaftenname | Datentyp | Zugang | Kann nach dem Starten der Verbindung geändert werden | Beschreibung |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Lese-/Schreibzugriff | Ja | Wenn Sie diese Eigenschaft auf True festlegen, wird die Clientsteuerung anstelle eines Remoteservers mit der untergeordneten Sitzung auf dem lokalen Computer verbunden. Wenn diese Eigenschaft auf truefestgelegt ist, können Sie keine Verbindung mit einem Remoteserver herstellen, da alle Verbindungen an localhost umgeleitet werden. Weitere Informationen zu untergeordneten Sitzungen finden Sie unter Untergeordnete Sitzungen. |
| DisableCredentialsDelegation | VT_BOOL | Lese-/Schreibzugriff | Nein | Wenn Truewerden anmeldeinformationen nicht an den Remoteserver gesendet. |
| EnableFrameBufferRedirection | VT_BOOL | Lese-/Schreibzugriff | Nein | Wenn Truewird versucht, die Framepufferumleitung zu versuchen. Bei einer Loopbackverbindung (derselbe Computer ist sowohl Client- als auch Server)-Framepufferumleitung ermöglicht die Gemeinsame Nutzung des Speichers für den Framepuffer zwischen den Sitzungen. |
| EnableHardwareMode | VT_BOOL | Schreibgeschützt | Nein | Wenn True, wird versucht, die Hardwareunterstützung für die Grafikdecodierung zu verwenden. |
| IgnoreCursors | VT_BOOL | Schreibgeschützt | Nein | Wenn True, werden cursor, die vom Remoteserver gesendet werden, ignoriert. |
| ManualClipboardSyncEnabled | VT_BOOL | Lese-/Schreibzugriff | Ja | Wenn Sie diese Eigenschaft auf True festlegen, werden die lokalen und Remoteablageablagen nicht automatisch synchronisiert. Stattdessen muss die IMsRdpClipboard Schnittstelle verwendet werden, um Zwischenablageformate aus der lokalen Zwischenablage mit der Remoteablage und der Remoteablage mit der lokalen Zwischenablage zu synchronisieren. |
| ZoomLevel | * VT_UI4 | Lese-/Schreibzugriff | Ja | Implementiert die Zoomfunktion mithilfe des RDP-ActiveX-Steuerelements. Die Zoomfunktion ist über das menü System von RDP verfügbar. Die eigenschaft ZoomLevel hat keine Auswirkung im RemoteApp-Modus und im Vollbildmodus. IMsRdpClientAdvancedSettings::SmartSizing und ZoomLevel schließen sich gegenseitig aus. |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | Nein | Wenn True, führt dies dazu, dass RemoteApp-Verbindungen vor Windows 8 auf die Legacy-Sprachleiste zurückgesetzt werden, anstatt die lokale Sprache automatisch mit der Remotesitzung zu synchronisieren. |
| RedirectTextProcessing | VT_BOOL | W | Nein | Ab Windows 11 23H2 wird die Umleitung der Textverarbeitung aktiviert/deaktiviert, die eine like-local-Erfahrung für Texteingabeszenarien bietet, z. B. IME, Emoticons. |
| HvSocketServiceId | VT_BSTR | W | Nein | Gibt das ServiceId-Feld des Hyper-V Sockets an,'s Adresse, an die der RDP-Datenverkehr gesendet werden soll. |
| DeviceScaleFactor | VT_UI4 | R/W | Nein | Gibt den Geräteskalierungsfaktor an, der in der Remotesitzung verwendet. Gültige Werte: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Nein | Aktiviert/deaktiviert die Umleitung des Standorts des lokalen Computers an die Remotesitzung. |
| AudioCaptureDevice | VT_BSTR | R/W | Nein | Gibt die Geräte-ID des Audioaufnahmegeräts an, das vom Client zur Remotesitzung umgeleitet werden soll. Anwendungen können die DRV_QUERYFUNCTIONINSTANCEID Nachricht verwenden, um die Geräte-ID des Audioaufnahmegeräts zu ermitteln, umzuleiten. Alternativ kann dies auf "Standard" festgelegt werden, um das Standardgerät oder "Keine" zu verwenden, um die Audioaufnahme zu deaktivieren. Standardmäßig ist dies auf "Standard" festgelegt. |
| RailMode | VT_BOOL | R | Nein | Gibt an, ob es sich um eine RemoteApp-Verbindung handelt. ITSRemoteProgram::RemoteProgramMode schreibt in diese Eigenschaft. |
| EnableRdsAadAuth | VT_BOOL | W | Nein | Wenn True, RDS AAD Auth Security verwendet wird. |
| RDGIsKDCProxy | VT_BOOL | W | Nein | Wenn True, weist der Client an, RD-Gateway (sofern angegeben) als KDC-Proxyserverzu verwenden. |
| UseURCP | VT_BOOL | R/W | Nein | Wenn True, aktiviert diese Eigenschaft das Universal Rate Control Protocol für UDP-basierte Remotedesktopverbindungen. Derzeit ist sie standardmäßig deaktiviert. Das Aktivieren, wenn UDP verwendet wird, wird empfohlen. |
| DesktopScaleFactor | VT_UI4 | R/W | Nein | Gibt den Geräteskalierungsfaktor an, der in der Remotesitzung verwendet. Der Wert sollte zwischen 100 und 500 (Prozent) liegen. |
| RedirectedAuthentication | VT_BOOL | W | Nein | Wenn True, Remote Credential Guard aktiviert ist. |
| RestrictedLogon | VT_BOOL | W | Nein | Wenn Trueist, eingeschränkter Administratormodus aktiviert ist. |
| AudioPlaybackDevice | VT_BSTR | R/W | Nein | Gibt die Geräte-ID des Audiowiedergabegeräts auf dem lokalen Computer an. Anwendungen können die DRV_QUERYFUNCTIONINSTANCEID Nachricht verwenden, um die Geräte-ID des Audiowiedergabegeräts zu ermitteln, umzuleiten. "Alternativ kann dies auf "Standard" festgelegt werden, um das Standardgerät oder "Keine" zu verwenden, um die Audiowiedergabe zu deaktivieren. Standardmäßig ist dies auf "Standard" festgelegt. " |
| SelectedMonitors | VT_BSTR | R/W | Nein | Eine durch Trennzeichen getrennte oder durch Semispalten getrennte Liste der Monitor-ID, um die ausgewählten Monitore zu identifizieren, auf denen die Remotesitzung angezeigt werden soll. Die erste ID in der Liste wird als primärer Monitor in der Remotesitzung behandelt. |
| WslgModeEnabled | VT_BOOL | W | Nein | Wenn True, ist die Sitzung eine WSLg-Sitzung. Es wird erwartet, dass die folgenden Eigenschaften bereitgestellt werden:
Weitere Informationen finden Sie in der Dokumentation https://github.com/microsoft/wslgvon WSLg. |
| ShowSessionDiagnostics | VT_BOOL | W | Ja | Wenn Sie True- in diese Eigenschaft schreiben, wird sofort ein Dialogfeld mit detaillierten Informationen zur Remotesitzung angezeigt. Diese Eigenschaft soll ein Debugmechanismus sein. Es unterliegt Änderungen und Entfernungen. |
| PrintingProgressMode | VT_UI4 | R/W | Nein | Mögliche Werte:
|
| CorrelationId | VT_BOOL | W | Nein | Überschreibt den von IMsRdpClientNonScriptable8::CorrelationId zurückgegebenen Wert. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Nein | Wenn True, wird die Remotesitzung nur mit DirectX ohne Fallback zu GDI angezeigt. Diese Eigenschaft gilt nicht für Remote-App-Sitzungen. Hinweis: Diese Eigenschaft unterliegt der Entfernung in zukünftigen Versionen von Windows, da der Nur-DirectX-Modus die einzige verfügbare Option wird. Dies ist derzeit ein Vorschaufeature, das nicht im Produktionscode aktiviert werden sollte. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Nein | Diese Eigenschaft wird nicht mehr unterstützt. Es unterliegt der Entfernung in zukünftigen Versionen von Windows. Verwenden Sie diese Eigenschaft nicht. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Nein | Wenn True und die eigenschaft ServerSupportsEdgeActionsTrueist, werden zusätzliche Befehle in der Verbindungssymbolleiste der Remotesitzung angezeigt. |
| TSGTransportIsUsed | VT_BOOL | R | N/A | Wenn True, wird ein Remotedesktopgateway für die zugeordnete Remotesitzung verwendet. |
| DiagnosticsInfo | VT_BSTR | W | Nein | Eine hexadezimale Zeichenfolge, die die rdpCorrelationInfo.correlationId Feld des Client X.224 Connection Request PDU-darstellt. |
| EndpointFedAuth | VT_BSTR | W | Nein | Das Token, das für anspruchsbasierte Verbund-RDSTLS-Authentifizierungverwendet wird. |
| AllowAxToContainerEvents | VT_BOOL | W | Nein | Diese Eigenschaft wurde in Windows 11 22H2 hinzugefügt.
|
| ServerSupportsEdgeActions | VT_BOOL | R | N/A | Schreibgeschützte Eigenschaft, um zu bestimmen, ob die Remotesitzung über die RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1-Funktion https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411verfügt. |
| AppContainerID | VT_BSTR | W | Nein | Die an IWorkspaceScriptable3::StartWorkspaceEx2 übergebene AppContainer-ID, wenn IMsRdpClientNonScriptable8::StartWorkspaceExtension aufgerufen wird. Hinweis: Die Systemsteuerung "RemoteApp" und "Desktopverbindungen" befindet sich nicht mehr in der aktiven Entwicklung. Sie kann in zukünftigen Versionen von Windows geändert oder nicht verfügbar sein. Die Verwendung dieser API wird abgeraten. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Nein | Wenn True, wird die programmgesteuerte Mausbewegung in der Remotesitzung ignoriert. Genauer gesagt werden die Zeigerpositionsaktualisierungs-PDU nicht angewendet. Siehe https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Nein | Diese Eigenschaft wird nicht mehr unterstützt. Es unterliegt der Entfernung in zukünftigen Versionen von Windows. Verwenden Sie diese Eigenschaft nicht. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Nein | Wenn True, werden erweiterte Monitorinformationen (z. B. EDIDs) beim Synchronisieren von Anzeigekonfigurationen an die Remotesitzung gesendet. |
| Arbeitsbereichs-ID | VT_BSTR | W | Nein | Der eindeutige Bezeichner der Verbindung in RemoteApp und Desktopverbindungen, zu dem die Remotesitzung gehört. |
| ShowConnectionInformation | VT_BOOL | W | Ja | Beim Schreiben True- in diese Eigenschaft wird das Dialogfeld "Verbindungsinformationen" angezeigt. |
| WslgSharedMemoryPath | VT_BSTR | W | Nein | Der Pfad zum Speichersitzungsobjekt zum Freigeben des Grafikpuffers für den virtuellen WSLg-Computer. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Nein | Die GUID, die der ausgeführten VM zugeordnet ist, die die Remoteanwendung hosten soll. Das Schreiben dieser Eigenschaft führt zu einer verbesserten Leistung für Remoteanwendungen, die aufgrund der Speicherfreigabe in einer lokalen VM ausgeführt werden. |
| KDCProxyName | VT_BSTR | W | Nein | "Gibt den vollqualifizierten Domänennamen eines KDC-Proxyservers (Key Distribution Center) an. Der KDC-Proxy ermöglicht RDP-Client die Verwendung des Kerberos-Authentifizierungsprotokolls, wenn er nicht direkt auf einen KDC zugreifen kann. Beispiel für den Eigenschaftswert: ""kdc.contoso.com"". Weitere Informationen finden Sie unter: Konfigurieren eines Kerberos-Schlüsselverteilungscenter-Proxys, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | Nein | Wenn True, werden Gesten auf Multitouchbildschirmen nicht an den Remoteserver gesendet. Standardmäßig ist dies auf Falsefestgelegt. |
| HvSocketEnabled | VT_BOOL | W | Nein | Wenn True, wird der Name des Remoteservers, wenn es sich um eine GUID handelt, als vmId-Feld der Adresse des Hyper-V Sockets interpretiert, an den der RDP-Datenverkehr gesendet werden soll. Standardmäßig ist dies auf Falsefestgelegt. Weitere Informationen zu Hyper-V Socketadressen finden Sie unter Binden an ein Hyper-V Socket-. |
| MultipenRemotingSupported | VT_BOOL | W | Nein | Wenn True, wird die gleichzeitige Einfügung von Eingaben von bis zu vier Stiftgeräten in der Remotesitzung unterstützt. Standardmäßig ist dies auf Falsefestgelegt. |
| ShowGatewayInformation | VT_BOOL | W | Ja | Beim Schreiben True- in diese Eigenschaft wird ein Dialogfeld mit Informationen zum Remotedesktopgateway angezeigt. Windows 11 22H2 und höher: Diese Eigenschaft wird nicht mehr unterstützt und durch die ShowConnectionInformation-Eigenschaft ersetzt. |
| DisableAutoReconnectComponent | VT_BOOL | W | Nein | Wenn True, wird die Serververbindung nicht getrennt und automatisch erneut verbunden, wenn die Netzwerkkonfiguration geändert wird. Standardmäßig ist dies auf Falsefestgelegt. |
| RedirectUsbDrive | VT_UI4 | R/W | Nein | Eingeführt in Windows 11, Version 24H2. Wenn sie nicht auf 0 festgelegt oder festgelegt ist, wird das USB-Usb-Usb-Stick als Laufwerksrichtung umgeleitet. Bei Festlegung auf 1 werden alle USB-Usb-Sticks automatisch als USB-Geräte umgeleitet. Bei Festlegung auf 2 werden USB-Usb-Sticks als USB-Geräte aufgeführt, die Benutzer können diese über die USB-Umleitung über die Benutzeroberfläche (Gerätedialogfeld in der Verbindungsleiste) oder den RDP-Dateieintrag "UsbDevicesToRedirect" umleiten. |
| Zulässige Sicherheitsprotokolle | VT_BSTR | W | Nein | Eingeführt in Windows 11, Version 24H2. Diese Eigenschaft wird verwendet, um die Liste der Sicherheitsprotokolle einzuschränken, die der Client aushandeln kann. Die tatsächliche Liste der ausgehandelten Protokolle wird durch andere Konfigurationseinstellungen und das Verbindungsszenario bestimmt und kann kleiner als die in dieser Eigenschaft angegebene Liste sein. Der Wert muss die Liste der Protokollnamen enthalten, die durch ';' getrennt sind, oder der Wert kann auf "" festgelegt werden, was bedeutet, dass alle normalerweise ausgehandelten Protokolle zulässig sind. Unterstützte Protokollnamen sind: "TLS", "CredSSP", "RDSTLS" und "RDS AAD Auth" Der Standardwert ist "". |
| AllowRelativeMouseMode | VT_BOOL | R/W | Nein | Eingeführt in Windows 11, Version 24H2. Bei True werden Mausbewegungen relativ zur aktuellen Mausposition dargestellt. |
| RemoteAppMouseMoveInject | VT_BOOL | W | Nein | Eingeführt in Windows 11, Version 24H2. Das Schreiben von True in diese Eigenschaft erzwingt das Einfügen einer Mausbewegung, wenn der Cursor ein RemoteApp-Fenster verlässt. Dies ist eine Problemumgehung für einen QuickInfo-Fehler. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client |
Windows 8 |
| Mindestens unterstützter Server |
Windows Server 2012 |
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting wird als 54d38bf7-b1ef-4479-9674-1bd6ea465258 definiert. CLSID_MsRdpClient8NotSafeForScripting wird als A3BC03A0-041D-42E3-AD22-882B7865C9C5 definiert. CLSID_MsRdpClient9NotSafeForScripting wird als 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings wird als 302D8188-0052-4807-806A-362B628F9AC5 definiert. |