Egenskapen IMsRdpExtendedSettings::P roperty
Innehåller en namngiven egenskap.
Den här egenskapen är läs/skriv.
Syntax
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Egenskapsvärde
Det namngivna egenskapsvärdet.
| Egenskapsnamn | Datatyp | Tillträde | Kan ändras när anslutningen har startats | Beskrivning |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Läsa/skriva | Ja | Om den här egenskapen anges till True gör att klientkontrollen ansluter till den underordnade sessionen på den lokala datorn i stället för en fjärrserver. Om den här egenskapen är inställd på santkan du inte ansluta till en fjärrserver eftersom alla anslutningar omdirigeras till localhost. Mer information om underordnade sessioner finns i underordnade sessioner. |
| DisableCredentialsDelegation | VT_BOOL | Läsa/skriva | Nej | Om Trueskickas inte autentiseringsuppgifterna till fjärrservern. |
| EnableFrameBufferRedirection | VT_BOOL | Läsa/skriva | Nej | Om Truegörs omdirigering av rambuffert. För en loopback-anslutning (samma dator är både klient och server) tillåter omdirigering av rambufferten att minnet för rambufferten delas mellan sessionerna. |
| EnableHardwareMode | VT_BOOL | Skrivskyddad | Nej | Om Truegörs ett försök till maskinvaruhjälp med grafikdekodning. |
| IgnoreCursors | VT_BOOL | Skrivskyddad | Nej | Om Trueignoreras markörer som skickas av fjärrservern. |
| ManualClipboardSyncEnabled | VT_BOOL | Läsa/skriva | Ja | Om du anger den här egenskapen till True innebär det att de lokala urklipp och fjärrurklipp inte synkroniseras automatiskt. I stället måste det IMsRdpClipboard--gränssnittet användas för att synkronisera Urklippsformat från det lokala Urklipp till fjärrurklippet och fjärrurklippet till det lokala Urklipp. |
| ZoomLevel | * VT_UI4 | Läsa/skriva | Ja | Implementerar zoomfunktionen med hjälp av RDP ActiveX-kontrollen. Zoomfunktionen är tillgänglig från System-menyn i RDP. Egenskapen ZoomLevel har ingen effekt i RemoteApp-läge och helskärmsläge. IMsRdpClientAdvancedSettings::SmartSizing och ZoomLevel är ömsesidigt uteslutande. |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | Nej | Om Truegör detta att RemoteApp-anslutningar återgår till det äldre språkfältet från före Windows 8, i stället för att automatiskt synkronisera det lokala språket till fjärrsessionen. |
| RedirectTextProcessing | VT_BOOL | W | Nej | Från och med Windows 11 23H2 aktiverar/inaktiverar omdirigering av textbearbetning som ger en liknande lokal upplevelse för textinmatningsscenarier, t.ex. IME, uttryckssymboler. |
| HvSocketServiceId | VT_BSTR | W | Nej | Anger fältet ServiceId för Hyper-V socketadress där RDP-trafiken ska skickas. |
| DeviceScaleFactor | VT_UI4 | R/W | Nej | Anger enhetsskalningsfaktor som används i fjärrsessionen. Giltiga värden: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Nej | Aktiverar/inaktiverar omdirigeringen av platsen för den lokala datorn till fjärrsessionen. |
| AudioCaptureDevice | VT_BSTR | R/W | Nej | Anger enhets-ID för ljudinspelningsenheten som ska omdirigeras från klienten till fjärrsessionen. Program kan använda meddelandet DRV_QUERYFUNCTIONINSTANCEID för att fastställa enhetens ID för ljudinspelningsenheten för omdirigering. Alternativt kan detta ställas in på "standard" för att använda standardenheten eller "ingen" för att inaktivera ljudinspelning. Som standard är detta inställt på "standard". |
| RailMode | VT_BOOL | R | Nej | Rapporterar om det här är en RemoteApp-anslutning. ITSRemoteProgram::RemoteProgramMode skrivningar till den här egenskapen. |
| EnableRdsAadAuth | VT_BOOL | W | Nej | Om Trueanvänds RDS AAD Auth Security. |
| RDGIsKDCProxy | VT_BOOL | W | Nej | Om Trueuppmanar du klienten att använda RD Gateway (om det anges) som en KDC-proxyserver. |
| UseURCP | VT_BOOL | R/W | Nej | Om Trueaktiverar den här egenskapen Universal Rate Control Protocol för UDP-baserade fjärrskrivbordsanslutningar. För närvarande är den inaktiverad som standard. Aktivera den om UDP används rekommenderas. |
| DesktopScaleFactor | VT_UI4 | R/W | Nej | Anger enhetsskalningsfaktor som används i fjärrsessionen. Värdet ska vara mellan 100 och 500 (procent). |
| RedirectedAuthentication | VT_BOOL | W | Nej | Om Trueaktiveras Remote Credential Guard. |
| RestrictedLogon | VT_BOOL | W | Nej | Om Santär begränsat administratörsläge aktiverat. |
| AudioPlaybackDevice | VT_BSTR | R/W | Nej | Anger enhets-ID för ljuduppspelningsenheten på den lokala datorn. Program kan använda meddelandet DRV_QUERYFUNCTIONINSTANCEID för att fastställa enhetens ID för ljuduppspelningsenheten för omdirigering. "Alternativt kan detta anges till "standard" för att använda standardenheten eller "ingen" för att inaktivera ljuduppspelning. Som standard är detta inställt på "standard". " |
| SelectedMonitors | VT_BSTR | R/W | Nej | En kommaavgränsad eller halvkolumnsavgränsad lista över övervaknings-ID för att identifiera de valda övervakarna där fjärrsessionen ska visas. Det första ID:t i listan behandlas som den primära övervakaren i fjärrsessionen. |
| WslgModeEnabled | VT_BOOL | W | Nej | Om Santär sessionen en WSLg-session. Följande egenskaper förväntas anges:
Se WSLgs dokumentation https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Ja | När du skriver True till den här egenskapen visas omedelbart en dialogruta med detaljerad information om fjärrsessionen. Den här egenskapen är avsedd att vara en felsökningsmekanism. Det kan komma att ändras och tas bort. |
| PrintingProgressMode | VT_UI4 | R/W | Nej | Möjliga värden:
|
| CorrelationId | VT_BOOL | W | Nej | Åsidosätter värdet som returneras av IMsRdpClientNonScriptable8::CorrelationId. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Nej | Om Truevisas fjärrsessionen endast med DirectX utan återställning till GDI. Den här egenskapen gäller inte för fjärrappsessioner. Obs! Den här egenskapen kan tas bort i framtida versioner av Windows eftersom DirectX-läget kan bli det enda tillgängliga alternativet. Det här är för närvarande en förhandsversionsfunktion som inte ska aktiveras i produktionskoden. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Nej | Den här egenskapen stöds inte längre. Det kan tas bort i framtida versioner av Windows. Använd inte den här egenskapen. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Nej | Om True och egenskapen ServerSupportsEdgeActions är Truevisas ytterligare kommandon i anslutningsfältet för fjärrsessionen. |
| TSGTransportIsUsed | VT_BOOL | R | Ej tillämpligt | Om Trueanvänds en fjärrskrivbordsgateway för den associerade fjärrsessionen. |
| DiagnosticsInfo | VT_BSTR | W | Nej | En hexadecimal sträng som representerar fältet rdpCorrelationInfo.correlationId i fältet Client X.224 Connection Request PDU. |
| EndpointFedAuth | VT_BSTR | W | Nej | Token som används för anspråksbaserad federerad RDSTLS-autentisering. |
| AllowAxToContainerEvents | VT_BOOL | W | Nej | Den här egenskapen lades till i Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | Ej tillämpligt | Skrivskyddad egenskap för att avgöra om fjärrsessionen har RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1-funktionen https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411. |
| AppContainerID | VT_BSTR | W | Nej | AppContainer-ID:t skickades till IWorkspaceScriptable3::StartWorkspaceEx2 när IMsRdpClientNonScriptable8::StartWorkspaceExtension anropas. Obs! Kontrollpanelen remoteapp- och skrivbordsanslutningar är inte längre i aktiv utveckling. Den kan ändras eller vara otillgänglig i framtida versioner av Windows. Användningen av det här API:et rekommenderas inte. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Nej | Om Trueignoreras musflytten som genereras programmatiskt i fjärrsessionen. Mer exakt tillämpas inte PDU för uppdatering av pekarposition. Se https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Nej | Den här egenskapen stöds inte längre. Det kan tas bort i framtida versioner av Windows. Använd inte den här egenskapen. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Nej | Om Trueskickas utökad övervakningsinformation (t.ex. EDID:er) till fjärrsessionen när visningskonfigurationer synkroniseras. |
| Arbetsyte-ID | VT_BSTR | W | Nej | Den unika identifieraren för anslutningen i RemoteApp- och Desktop-anslutningar som fjärrsessionen tillhör. |
| ShowConnectionInformation | VT_BOOL | W | Ja | När du skriver True till den här egenskapen visas dialogrutan Anslutningsinformation. |
| WslgSharedMemoryPath | VT_BSTR | W | Nej | Sökvägen till minnessessionsobjektet för att dela grafikbuffert med den virtuella WSLg-datorn. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Nej | DET GUID som är associerat med den virtuella dator som körs som värd för fjärrprogrammet. Om du skriver den här egenskapen får du bättre prestanda för fjärrprogram som körs på en lokal virtuell dator på grund av minnesdelning. |
| KDCProxyName | VT_BSTR | W | Nej | "Anger fullständigt kvalificerat domännamn för en KDC-proxyserver (Key Distribution Center). Med KDC Proxy kan RDP-klienten använda Kerberos-autentiseringsprotokoll när det inte kan komma åt en KDC direkt. Exempel på egenskapsvärdet: ""kdc.contoso.com". Mer information finns i: Konfigurera en Kerberos Key Distribution Center-proxy, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | Nej | Om Trueskickas inte gester på flera pekskärmar till fjärrservern. Som standard är detta inställt på False. |
| HvSocketEnabled | VT_BOOL | W | Nej | Om Truetolkas fjärrserverns namn, om det är ett GUID, som fältet VmId i Hyper-V socketadress där RDP-trafiken ska skickas. Som standard är detta inställt på False. Mer information om Hyper-V socketadresser finns i Bind till en Hyper-V socket. |
| MultipenRemotingSupported | VT_BOOL | W | Nej | Om Truestöds samtidig inmatning av indata från upp till fyra pennenheter i fjärrsessionen. Som standard är detta inställt på False. |
| ShowGatewayInformation | VT_BOOL | W | Ja | När du skriver True till den här egenskapen visas en dialogruta som visar information om fjärrskrivbordsgatewayen. Windows 11 22H2 och senare: Den här egenskapen stöds inte längre och ersattes av egenskapen ShowConnectionInformation. |
| DisableAutoReconnectComponent | VT_BOOL | W | Nej | Om Truekopplas inte serveranslutningen från och återansluts automatiskt när nätverkskonfigurationen ändras. Som standard är detta inställt på False. |
| RedirectUsbDrive | VT_UI4 | R/W | Nej | Introducerades i Windows 11 version 24H2. När den inte är inställd eller inställd på 0 omdirigeras USB-tumenheten som enhetsriktning. När det är inställt på 1 omdirigeras alla USB-tumenheter automatiskt som USB-enheter. När det är inställt på 2 visas USB-tumenheter som USB-enheter, användare kan välja att omdirigera dem via USB-omdirigering från användargränssnittet (enhetsdialogrutan i anslutningsfältet) eller RDP-filposten "UsbDevicesToRedirect". |
| tillåtna säkerhetsprotokoll | VT_BSTR | W | Nej | Introducerades i Windows 11 version 24H2. Den här egenskapen används för att begränsa listan över säkerhetsprotokoll som klienten kan förhandla om. Den faktiska listan över förhandlade protokoll bestäms av andra konfigurationsinställningar och anslutningsscenariot och kan vara mindre än listan som anges i den här egenskapen. Värdet måste innehålla listan med protokollnamn avgränsade med ';' eller så kan värdet anges till "" vilket innebär att alla normalt förhandlade protokoll tillåts. Protokollnamn som stöds är: "TLS", "CredSSP", "RDSTLS" och "RDS AAD Auth" Standardvärdet är "". |
| AllowRelativeMouseMode | VT_BOOL | R/W | Nej | Introducerades i Windows 11 version 24H2. Om sant representeras musrörelser i förhållande till den aktuella muspositionen. |
| RemoteAppMouseMoveInject | VT_BOOL | W | Nej | Introducerades i Windows 11 version 24H2. Om du skriver Sant till den här egenskapen så tvingar du inmatningen av en mus när markören lämnar ett RemoteApp-fönster. Detta är avsett att vara en lösning för ett knappbeskrivningsfel. |
Krav
| Krav | Värde |
|---|---|
| Lägsta klient som stöds |
Windows 8 |
| Lägsta server som stöds |
Windows Server 2012 |
| Skriv bibliotek |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting definieras som 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting definieras som A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting definieras som 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings definieras som 302D8188-0052-4807-806A-362B628F9AC5 |