Eigenschap IMsRdpExtendedSettings::P roperty
Bevat een benoemde eigenschap.
Deze eigenschap is lezen/schrijven.
Syntaxis
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Eigenschapswaarde
De benoemde eigenschapswaarde.
| Naam van eigenschap | Gegevenstype | Toegang | Kan worden gewijzigd nadat de verbinding is gestart | Beschrijving |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Lezen/schrijven | Ja | Als u deze eigenschap instelt op True zorgt u ervoor dat het clientbesturingselement verbinding maakt met de onderliggende sessie op de lokale computer in plaats van een externe server. Als deze eigenschap is ingesteld op true, kunt u geen verbinding maken met een externe server omdat alle verbindingen worden omgeleid naar localhost. Zie Onderliggende sessiesvoor meer informatie over onderliggende sessies. |
| DisableCredentialsDelegation | VT_BOOL | Lezen/schrijven | Nee | Als Waar, worden referenties niet naar de externe server verzonden. |
| EnableFrameBufferRedirection | VT_BOOL | Lezen/schrijven | Nee | Als True, wordt geprobeerd framebufferomleiding te gebruiken. Voor een loopback-verbinding (dezelfde computer is zowel client als server) kan het geheugen voor de framebuffer worden gedeeld tussen de sessies. |
| EnableHardwareMode | VT_BOOL | Alleen schrijven | Nee | Als True, wordt geprobeerd om hardware te helpen bij het decoderen van afbeeldingen. |
| IgnoreCursors | VT_BOOL | Alleen schrijven | Nee | Als Waar, worden cursors die door de externe server worden verzonden, genegeerd. |
| ManualClipboardSyncEnabled | VT_BOOL | Lezen/schrijven | Ja | Als u deze eigenschap instelt op True betekent dit dat de lokale en externe klemborden niet automatisch worden gesynchroniseerd. In plaats daarvan moet de IMsRdpClipboard interface worden gebruikt voor het synchroniseren van klembordindelingen van het lokale klembord naar het externe klembord en het externe klembord naar het lokale klembord. |
| ZoomLevel | * VT_UI4 | Lezen/schrijven | Ja | Hiermee wordt de zoomfunctie geïmplementeerd met behulp van het RDP ActiveX-besturingselement. De zoomfunctie is beschikbaar in het menu System van RDP. De eigenschap ZoomLevel heeft geen effect in de RemoteApp-modus en de modus Volledig scherm. IMsRdpClientAdvancedSettings::SmartSizing en ZoomLevel sluiten elkaar wederzijds uit. |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | Nee | Als True, worden RemoteApp-verbindingen teruggezet naar de verouderde taalbalk van vóór Windows 8, in plaats van de lokale taal automatisch te synchroniseren met de externe sessie. |
| RedirectTextProcessing | VT_BOOL | W | Nee | Vanaf Windows 11 23H2 schakelt u de omleiding van tekstverwerking in of uit, wat een achtige lokale ervaring biedt voor tekstinvoerscenario's, bijvoorbeeld IME, emoticons. |
| HvSocketServiceId | VT_BSTR | W | Nee | Hiermee geeft u het veld ServiceId van de Hyper-V socketadres waar het RDP-verkeer moet worden verzonden. |
| DeviceScaleFactor | VT_UI4 | R/W | Nee | Hiermee geeft u de apparaatschaalfactor gebruikt in de externe sessie. Geldige waarden: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Nee | Hiermee schakelt u de omleiding van de locatie van de lokale computer naar de externe sessie in of uit. |
| AudioCaptureDevice | VT_BSTR | R/W | Nee | Hiermee geeft u de apparaat-id van het audio-opnameapparaat om om te leiden van de client naar de externe sessie. Toepassingen kunnen het DRV_QUERYFUNCTIONINSTANCEID bericht gebruiken om de apparaat-id van het audio-opnameapparaat te bepalen om te leiden. U kunt dit ook instellen op 'standaard' om het standaardapparaat of 'geen' te gebruiken om audio-opname uit te schakelen. Dit is standaard ingesteld op 'standaard'. |
| RailMode | VT_BOOL | R | Nee | Rapporteert of dit een RemoteApp-verbinding is. ITSRemoteProgram::RemoteProgramMode naar deze eigenschap schrijft. |
| EnableRdsAadAuth | VT_BOOL | W | Nee | Als True, wordt RDS AAD-verificatiebeveiliging gebruikt. |
| RDGIsKDCProxy | VT_BOOL | W | Nee | Als True, geeft de client aan dat deze RD-gateway (indien opgegeven) moet gebruiken als een KDC-proxyserver. |
| UseURCP | VT_BOOL | R/W | Nee | Als True, schakelt u met deze eigenschap het Universal Rate Control Protocol in voor verbindingen met extern bureaublad op basis van UDP. Op dit moment is deze standaard uitgeschakeld. Inschakelen als UDP wordt gebruikt, wordt aanbevolen. |
| DesktopScaleFactor | VT_UI4 | R/W | Nee | Hiermee geeft u de apparaatschaalfactor gebruikt in de externe sessie. De waarde moet tussen 100 en 500 (procent) zijn. |
| RedirectedAuthentication | VT_BOOL | W | Nee | Als Trueis, is Remote Credential Guard ingeschakeld. |
| RestrictedLogon | VT_BOOL | W | Nee | Als Waar, is beperkte beheermodus ingeschakeld. |
| AudioPlaybackDevice | VT_BSTR | R/W | Nee | Hiermee geeft u de apparaat-id van het audio-afspeelapparaat op de lokale computer. Toepassingen kunnen het DRV_QUERYFUNCTIONINSTANCEID bericht gebruiken om de apparaat-id van het afspeelapparaat voor audio om te leiden. U kunt dit ook instellen op ''standaard'' om het standaardapparaat of 'geen' te gebruiken om het afspelen van audio uit te schakelen. Dit is standaard ingesteld op ''default'. " |
| SelectedMonitors | VT_BSTR | R/W | Nee | Een door komma's gescheiden of semi-kolom-gescheiden lijst met monitor-id's om de geselecteerde monitors te identificeren waar de externe sessie moet worden weergegeven. De eerste id in de lijst wordt behandeld als de primaire monitor in de externe sessie. |
| WslgModeEnabled | VT_BOOL | W | Nee | Als True, is de sessie een WSLg-sessie. Naar verwachting worden de volgende eigenschappen opgegeven:
Raadpleeg de documentatie van WSLg https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Ja | Als u True naar deze eigenschap schrijft, wordt direct een dialoogvenster met gedetailleerde informatie over de externe sessie weergegeven. Deze eigenschap is bedoeld als een foutopsporingsmechanisme. Het is onderhevig aan wijziging en verwijdering. |
| PrintingProgressMode | VT_UI4 | R/W | Nee | Mogelijke waarden:
|
| CorrelationId | VT_BOOL | W | Nee | Overschrijft de waarde die wordt geretourneerd door IMsRdpClientNonScriptable8::CorrelationId. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Nee | Als True, wordt de externe sessie alleen weergegeven met DirectX zonder terugval naar GDI. Deze eigenschap is niet van toepassing op externe app-sessies. Opmerking: deze eigenschap is onderhevig aan verwijdering in toekomstige versies van Windows, omdat de DirectX-modus mogelijk de enige beschikbare optie wordt. Dit is momenteel een preview-functie die niet mag worden ingeschakeld in productiecode. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Nee | Deze eigenschap wordt niet meer ondersteund. Het is onderhevig aan verwijdering in toekomstige versies van Windows. Gebruik deze eigenschap niet. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Nee | Als True en de eigenschap ServerSupportsEdgeActions is True, worden extra opdrachten weergegeven op de verbindingswerkbalk van de externe sessie. |
| TSGTransportIsed | VT_BOOL | R | N.V.T | Als Waar, wordt een extern bureaublad-gateway gebruikt voor de bijbehorende externe sessie. |
| DiagnosticsInfo | VT_BSTR | W | Nee | Een hexadecimale tekenreeks die het rdpCorrelationInfo.correlationId veld van het Client X.224 Verbindingsaanvraag PDUvertegenwoordigt. |
| EndpointFedAuth | VT_BSTR | W | Nee | Het token dat wordt gebruikt voor federatieve RDSTLS-verificatie op basis van claims. |
| AllowAxToContainerEvents | VT_BOOL | W | Nee | Deze eigenschap is toegevoegd in Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | N.V.T | Alleen-lezen eigenschap om te bepalen of de externe sessie de RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 mogelijkheid heeft https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411. |
| AppContainerID | VT_BSTR | W | Nee | De AppContainer-id die is doorgegeven aan IWorkspaceScriptable3::StartWorkspaceEx2 wanneer IMsRdpClientNonScriptable8::StartWorkspaceExtension wordt aangeroepen. Opmerking: Het configuratiescherm RemoteApp en Desktop Connections bevindt zich niet meer in actieve ontwikkeling. Het kan worden gewijzigd of niet beschikbaar in toekomstige versies van Windows. Het gebruik van deze API wordt afgeraden. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Nee | Als Waar, worden de muis verplaatst die programmatisch in de externe sessie wordt gegenereerd, genegeerd. Precies gezegd, de Pointer Position Update PDU wordt niet toegepast. Zie https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Nee | Deze eigenschap wordt niet meer ondersteund. Het is onderhevig aan verwijdering in toekomstige versies van Windows. Gebruik deze eigenschap niet. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Nee | Als True, worden uitgebreide monitorgegevens (bijvoorbeeld EDID's) verzonden naar de externe sessie bij het synchroniseren van weergaveconfiguraties. |
| Werkruimte-id | VT_BSTR | W | Nee | De unieke id van de verbinding in RemoteApp- en desktopverbindingen waartoe de externe sessie behoort. |
| ShowConnectionInformation | VT_BOOL | W | Ja | Als u True naar deze eigenschap schrijft, wordt het dialoogvenster Verbindingsgegevens weergegeven. |
| WslgSharedMemoryPath | VT_BSTR | W | Nee | Het pad naar het geheugensessieobject voor het delen van een grafische buffer met de virtuele WSLg-machine. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Nee | De GUID die is gekoppeld aan de actieve VM die als host fungeert voor de externe toepassing. Het schrijven van deze eigenschap resulteert in verbeterde prestaties voor externe toepassingen die worden uitgevoerd op een lokale VM vanwege het delen van geheugen. |
| KDCProxyName | VT_BSTR | W | Nee | "Hiermee geeft u volledig gekwalificeerde domeinnaam van een KDC-proxyserver (Key Distribution Center) op. Met de KDC-proxy kan de RDP-client kerberos-verificatieprotocol gebruiken wanneer deze geen rechtstreeks toegang heeft tot een KDC. Voorbeeld van de eigenschapswaarde: ''kdc.contoso.com'. Zie voor meer informatie: Een kerberos-sleuteldistributiecentrumproxy configureren, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | Nee | Als True, worden gebaren op schermen met meerdere aanraakschermen niet naar de externe server verzonden. Dit is standaard ingesteld op False. |
| HvSocketEnabled | VT_BOOL | W | Nee | Als Waar, wordt de naam van de externe server, als het een GUID is, geïnterpreteerd als het veld VmId van het adres van de Hyper-V socket waar het RDP-verkeer moet worden verzonden. Dit is standaard ingesteld op False. Raadpleeg Bind aan een Hyper-V socketvoor meer informatie over de adressen van Hyper-V sockets. |
| MultipenRemotingSupported | VT_BOOL | W | Nee | Als True, wordt de gelijktijdige injectie van invoer van maximaal vier penapparaten ondersteund in de externe sessie. Dit is standaard ingesteld op False. |
| ShowGatewayInformation | VT_BOOL | W | Ja | Als u Waar naar deze eigenschap schrijft, ziet u een dialoogvenster met informatie over de extern bureaublad-gateway. Windows 11 22H2 en hoger: deze eigenschap wordt niet meer ondersteund en is vervangen door de eigenschap ShowConnectionInformation. |
| DisableAutoReconnectComponent | VT_BOOL | W | Nee | Als True, wordt de verbinding met de server niet verbroken en automatisch opnieuw verbonden wanneer de netwerkconfiguratie wordt gewijzigd. Dit is standaard ingesteld op False. |
| RedirectUsbDrive | VT_UI4 | R/W | Nee | Geïntroduceerd in Windows 11 versie 24H2. Wanneer deze niet is ingesteld of ingesteld op 0, wordt het USB-duimstation omgeleid als stationsrichting. Als deze is ingesteld op 1, worden alle USB-duimstations automatisch omgeleid als USB-apparaten. Wanneer deze optie is ingesteld op 2, worden USB-duimstations vermeld als USB-apparaten, kunnen gebruikers ervoor kiezen om ze om te leiden via USB-omleiding vanuit de gebruikersinterface (dialoogvenster apparaat in de verbindingsbalk) of RDP-bestandsvermelding 'UsbDevicesToRedirect'. |
| toegestane beveiligingsprotocollen | VT_BSTR | W | Nee | Geïntroduceerd in Windows 11 versie 24H2. Deze eigenschap wordt gebruikt om de lijst met beveiligingsprotocollen te beperken die de client kan onderhandelen. De werkelijke lijst met onderhandelde protocollen wordt bepaald door andere configuratie-instellingen en het verbindingsscenario en kan kleiner zijn dan de lijst die in deze eigenschap is opgegeven. De waarde moet de lijst met protocolnamen bevatten, gescheiden door ';' of de waarde kan worden ingesteld op '', wat betekent dat alle normaal overeengekomen protocollen zijn toegestaan. Ondersteunde protocolnamen zijn: "TLS", "CredSSP", "RDSTLS" en "RDS AAD-verificatie" De standaardwaarde is "". |
| AllowRelativeMouseMode | VT_BOOL | R/W | Nee | Geïntroduceerd in Windows 11 versie 24H2. Indien waar, worden muisbewegingen weergegeven ten opzichte van de huidige muispositie. |
| RemoteAppMouseMoveInject | VT_BOOL | W | Nee | Geïntroduceerd in Windows 11 versie 24H2. Als true naar deze eigenschap wordt geschreven, wordt de injectie van een muis verplaatst wanneer de cursor een RemoteApp-venster verlaat. Dit is bedoeld als tijdelijke oplossing voor een fout in knopinfo. |
Eisen
| Eis | Waarde |
|---|---|
| Minimaal ondersteunde client |
Windows 8 |
| Minimaal ondersteunde server |
Windows Server 2012 |
| Typebibliotheek |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting wordt gedefinieerd als 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting is gedefinieerd als A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting is gedefinieerd als 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings wordt gedefinieerd als 302D8188-0052-4807-806A-362B628F9AC5 |