Freigeben über


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:
  • WslgSharedMemoryPath
  • HvSocketEnabled
  • HvSocketServiceId

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:
  • 0: Das Statusdialogfeld, das angezeigt wird, wenn das Drucken deaktiviert ist
  • 1: Das Beim Drucken angezeigte Statusdialogfeld enthält grundlegende Informationen.
  • 2: Das Beim Drucken angezeigte Statusdialogfeld enthält detaillierte Informationen.
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.
  • Wenn False- (Standardverhalten ab Windows 11 22H2) werden STRG+ALT+PFEILtastenkombinationen an die Remotesitzung gesendet.
  • Wenn True (Standardverhalten vor Windows 11 22H2) löst STRG+ALT+PFEILtastenkombinationen eine IMsTscAxEvents::OnFocusReleased Ereignis für die Anwendung aus.
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
MsTscAx.dll
DLL
MsTscAx.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.

Siehe auch

IMsRdpExtendedSettings