IMsRdpExtendedSettings::Property-Eigenschaft
Enthält eine benannte Eigenschaft.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Eigenschaftswert
Der Wert der benannten Eigenschaft.
| Eigenschaftenname | Datentyp | Access | Kann nach dem Starten der Verbindung geändert werden | Beschreibung |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Lesen/Schreiben | Ja | Wenn Sie diese Eigenschaft auf TRUE festlegen, wird eine Verbindung mit der untergeordneten Sitzung auf dem lokalen Computer hergestellt und nicht mit dem Remoteserver. Wenn diese Eigenschaft auf TRUE festgelegt 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 | Lesen/Schreiben | Nein | Bei TRUE werden die Anmeldeinformationen nicht an den Remoteserver gesendet. |
| EnableFrameBufferRedirection | VT_BOOL | Lesen/Schreiben | Nein | Bei TRUE wird versucht, die Framepufferumleitung zu verwenden. Bei einer Loopbackverbindung (derselbe Computer ist sowohl Client als auch Server) ermöglicht die Framepufferumleitung die gemeinsame Nutzung des Speichers für den Framepuffer durch die Sitzungen. |
| EnableHardwareMode | VT_BOOL | Nur Schreiben | Nein | Bei TRUE wird bei der Grafikdecodierung versucht, die die Hardwareunterstützung zu nutzen. |
| IgnoreCursors | VT_BOOL | Nur Schreiben | Nein | Bei TRUE werden vom Remoteserver gesendete Cursor ignoriert. |
| ManualClipboardSyncEnabled | VT_BOOL | Lesen/Schreiben | Ja | Beim Festlegen dieser Eigenschaft auf TRUE werden die lokalen und Remotezwischenablagen nicht automatisch synchronisiert. Stattdessen muss die IMsRdpClipboard-Schnittstelle verwendet werden, um Zwischenablageformate zwischen der lokalen Zwischenablage und der Remotezwischenablage zu synchronisieren. |
| ZoomLevel | *VT_UI4 | Lesen/Schreiben | Ja | Implementiert die Zoomfunktion mithilfe des RDP-ActiveX-Steuerelements. Die Zoomfunktion ist im Menü System von RDP verfügbar. Die ZoomLevel-Eigenschaft hat im RemoteApp-Modus und im Vollbildmodus keine Auswirkungen. IMsRdpClientAdvancedSettings::SmartSizing und ZoomLevel schließen sich gegenseitig aus. |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | Ohne | Der Wert TRUE bewirkt, dass RemoteApp-Verbindungen vor Windows 8 auf die Legacysprachleiste zurückgesetzt werden, anstatt die lokale Sprache automatisch mit der Remotesitzung zu synchronisieren. |
| RedirectTextProcessing | VT_BOOL | W | Ohne | Ab Windows 11 23H2 wird die Umleitung der Textverarbeitung aktiviert/deaktiviert, die für Texteingabeszenarien eine ähnliche Erfahrung wie das lokale Arbeiten bietet, z. B. IME, Emoticons. |
| HvSocketServiceId | VT_BSTR | W | Ohne | Gibt das ServiceId-Feld der Adresse des Hyper-V-Sockets an, an die der RDP-Datenverkehr gesendet werden soll. |
| DeviceScaleFactor | VT_UI4 | R/W | Ohne | Gibt den in der Remotesitzung verwendeten Geräteskalierungsfaktor an. Gültige Werte: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Ohne | Aktiviert/deaktiviert die Umleitung des Standorts vom lokalen Computer an die Remotesitzung. |
| AudioCaptureDevice | VT_BSTR | R/W | Ohne | Gibt die Geräte-ID des Audioaufnahmegeräts an, das vom Client zur Remotesitzung umgeleitet werden soll. Anwendungen können die Nachricht DRV_QUERYFUNCTIONINSTANCEID verwenden, um die Geräte-ID des Audioaufnahmegeräts zu ermitteln, das umgeleitet werden soll. Alternativ kann „default“ festgelegt werden, um das Standardgerät zu verwenden, oder „none“, um die Audioaufnahme zu deaktivieren. Dieser Wert ist standardmäßig auf „default“ festgelegt. |
| RailMode | VT_BOOL | R | Ohne | Meldet, ob es sich um eine RemoteApp-Verbindung handelt. ITSRemoteProgram::RemoteProgramMode schreibt in diese Eigenschaft. |
| EnableRdsAadAuth | VT_BOOL | W | Ohne | Bei TRUE wird RDS-Sicherheit durch AAD-Authentifizierung verwendet. |
| RDGIsKDCProxy | VT_BOOL | W | Ohne | Bei TRUE wird der Client angewiesen, das RD-Gateway (sofern angegeben) als KDC-Proxyserver zu verwenden. |
| UseURCP | VT_BOOL | R/W | Ohne | Bei TRUE aktiviert diese Eigenschaft das Universal Rate Control Protocol für UDP-basierte Remotedesktopverbindungen. Derzeit ist es standardmäßig deaktiviert. Eine Aktivierung wird empfohlen, wenn UDP verwendet wird. |
| DesktopScaleFactor | VT_UI4 | R/W | Ohne | Gibt den in der Remotesitzung verwendeten Geräteskalierungsfaktor an. Der Wert muss zwischen 100 und 500 (Prozent) liegen. |
| RedirectedAuthentication | VT_BOOL | W | Ohne | Bei TRUE wird der Remote Credential Guard aktiviert. |
| RestrictedLogon | VT_BOOL | W | Ohne | Bei TRUE wird der eingeschränkte Administratormodus aktiviert. |
| AudioPlaybackDevice | VT_BSTR | R/W | Ohne | Gibt die Geräte-ID des Audiowiedergabegeräts auf dem lokalen Computer an. Anwendungen können die Nachricht DRV_QUERYFUNCTIONINSTANCEID verwenden, um die Geräte-ID des Audiowiedergabegeräts zu ermitteln, das umgeleitet werden soll. Alternativ kann „default“ festgelegt werden, um das Standardgerät zu verwenden, oder „none“, um die Audiowiedergabe zu deaktivieren. Dieser Wert ist standardmäßig auf „default“ festgelegt. " |
| SelectedMonitors | VT_BSTR | R/W | Ohne | Eine durch Trennzeichen (Komma oder Semikolon) getrennte Liste der Monitor-IDs, 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 für die Remotesitzung behandelt. |
| WslgModeEnabled | VT_BOOL | W | Ohne | Bei TRUE handelt es sich bei der Sitzung um eine WSLg-Sitzung. Es wird erwartet, dass die folgenden Eigenschaften angegeben werden:
Weitere Informationen finden Sie in der Dokumentation zu WSLg: https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Ja. | Wenn Sie diese Eigenschaft auf TRUE festlegen, wird sofort ein Dialogfeld mit detaillierten Informationen zur Remotesitzung angezeigt. Diese Eigenschaft ist für das Debuggen vorgesehen. Sie kann geändert oder entfernt werden. |
| PrintingProgressMode | VT_UI4 | R/W | Ohne | Mögliche Werte:
|
| CorrelationId | VT_BOOL | W | Ohne | Überschreibt den von IMsRdpClientNonScriptable8::CorrelationId zurückgegebenen Wert. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Ohne | Bei TRUE wird die Remotesitzung nur mit DirectX ohne Fallback zu GDI angezeigt. Diese Eigenschaft gilt nicht für Remote-App-Sitzungen. Hinweis: Diese Eigenschaft wird in zukünftigen Versionen von Windows entfernt, da der reine DirectX-Modus die einzige verfügbare Option wird. Dies ist derzeit eine Previewfunktion, die in Produktionscode nicht aktiviert werden sollte. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Ohne | Diese Eigenschaft wird nicht mehr unterstützt. Sie wird in zukünftigen Versionen von Windows entfernt. Verwenden Sie diese Eigenschaft nicht. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Ohne | Wenn der Wert TRUE lautet und die ServerSupportsEdgeActions-Eigenschaft ebenfalls auf TRUE festgelegt ist, werden auf der Verbindungssymbolleiste der Remotesitzung zusätzliche Befehle angezeigt. |
| TSGTransportIsUsed | VT_BOOL | R | NICHT ZUTREFFEND | Bei TRUE wird ein Remotedesktopgateway für die zugeordnete Remotesitzung verwendet. |
| DiagnosticsInfo | VT_BSTR | W | Ohne | Eine hexadezimale Zeichenfolge, die das rdpCorrelationInfo.correlationId-Feld der X.224-Verbindungsanforderungs-PDU des Clients darstellt. |
| EndpointFedAuth | VT_BSTR | W | Ohne | Das Token, das für die anspruchsbasierte RDSTLS-Verbundauthentifizierung verwendet wird. |
| AllowAxToContainerEvents | VT_BOOL | W | Ohne | Diese Eigenschaft wurde in Windows 11 22H2 hinzugefügt.
|
| ServerSupportsEdgeActions | VT_BOOL | R | NICHT ZUTREFFEND | Schreibgeschützte Eigenschaft, die angibt, 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-7d634e10b411 verfügt. |
| AppContainerID | VT_BSTR | W | Ohne | Die an IWorkspaceScriptable3::StartWorkspaceEx2 übergebene AppContainer-ID, wenn IMsRdpClientNonScriptable8::StartWorkspaceExtension aufgerufen wird. Hinweis: Die Systemsteuerung „RemoteApp- und Desktopverbindung“ wird nicht mehr aktiv weiterentwickelt. Sie kann in zukünftigen Versionen von Windows geändert werden oder nicht mehr verfügbar sein. Von der Verwendung dieser API wird abgeraten. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Ohne | Bei TRUE werden programmgesteuerte Mausbewegungen in der Remotesitzung ignoriert. Genauer gesagt wird die Aktualisierungs-PDU für die Zeigerposition nicht angewandt. Siehe https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Ohne | Diese Eigenschaft wird nicht mehr unterstützt. Sie wird in zukünftigen Versionen von Windows entfernt. Verwenden Sie diese Eigenschaft nicht. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Ohne | Bei TRUE werden erweiterte Monitorinformationen (z. B. EDIDs) beim Synchronisieren von Anzeigekonfigurationen an die Remotesitzung gesendet. |
| Arbeitsbereichs-ID | VT_BSTR | W | Ohne | Der eindeutige Bezeichner der Verbindung in RemoteApp- und Desktopverbindung, zu der die Remotesitzung gehört. |
| ShowConnectionInformation | VT_BOOL | W | Ja. | Wenn Sie diese Eigenschaft auf TRUE festlegen, wird das Dialogfeld „Verbindungsinformationen“ angezeigt. |
| WslgSharedMemoryPath | VT_BSTR | W | Ohne | Der Pfad zum Speichersitzungsobjekt für das Freigeben des Grafikpuffers für die WSLg-VM. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Ohne | Die GUID, die der ausgeführten VM zugeordnet ist, auf der die Remoteanwendung gehostet wird. Das Festlegen dieser Eigenschaft führt zu einer verbesserten Leistung von Remoteanwendungen, die aufgrund der Speicherfreigabe auf einer lokalen VM ausgeführt werden. |
| KDCProxyName | VT_BSTR | W | Ohne | Gibt den vollqualifizierten Domänennamen eines KDC-Proxyservers (Key Distribution Center) an. Der KDC-Proxy ermöglicht RDP-Clients die Verwendung des Kerberos-Authentifizierungsprotokolls, wenn sie nicht direkt auf ein KDC zugreifen können. 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 | Ohne | Bei TRUE werden Gesten auf Multitouchbildschirmen nicht an den Remoteserver gesendet. Dieser Wert ist standardmäßig auf FALSE festgelegt. |
| HvSocketEnabled | VT_BOOL | W | Ohne | Bei TRUE wird der Name des Remoteservers, wenn es sich um eine GUID handelt, als VmId-Feld der Adresse des Hyper-V-Sockets interpretiert, an die der RDP-Datenverkehr gesendet werden soll. Dieser Wert ist standardmäßig auf FALSE festgelegt. Weitere Informationen zu den Adressen von Hyper-V-Sockets finden Sie unter Binden an ein Hyper-V-Socket. |
| MultipenRemotingSupported | VT_BOOL | W | Ohne | Bei TRUE wird die gleichzeitige Einfügung von Eingaben von bis zu vier Stiftgeräten in der Remotesitzung unterstützt. Dieser Wert ist standardmäßig auf FALSE festgelegt. |
| ShowGatewayInformation | VT_BOOL | W | Ja. | Wenn Sie diese Eigenschaft auf TRUE festlegen, 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. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 8 |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 |
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting ist definiert als 54d38bf7-b1ef-4479-9674-1bd6ea465258. CLSID_MsRdpClient8NotSafeForScripting ist definiert als A3BC03A0-041D-42E3-AD22-882B7865C9C5. CLSID_MsRdpClient9NotSafeForScripting ist definiert als 8B918B82-7985-4C24-89DF-C33AD2BBFBCD. |
| IID |
IID_IMsRdpExtendedSettings ist definiert als 302D8188-0052-4807-806A-362B628F9AC5. |