IMsRdpExtendedSettings::P roperty – vlastnost
Obsahuje pojmenovanou vlastnost.
Tato vlastnost je pro čtení a zápis.
Syntax
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Hodnota vlastnosti
Pojmenovaná hodnota vlastnosti.
| Název vlastnosti | Datový typ | Přístup | Po spuštění připojení je možné změnit. | Popis |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Čtení a zápis | Ano | Nastavení této vlastnosti na True způsobí, že se klientský ovládací prvek připojí k podřízené relaci na místním počítači místo vzdáleného serveru. Pokud je tato vlastnost nastavena na true, nemůžete se připojit ke vzdálenému serveru, protože všechna připojení jsou přesměrována na localhost. Další informace o podřízených relacích naleznete v tématu podřízené relace. |
| DisableCredentialsDelegation | VT_BOOL | Čtení a zápis | Ne | Pokud true, přihlašovací údaje se neodesílají na vzdálený server. |
| EnableFrameBufferRedirection | VT_BOOL | Čtení a zápis | Ne | Pokud true, dojde k pokusu o přesměrování vyrovnávací paměti rámce. Přesměrování vyrovnávací paměti pro zpětné smyčky (stejný počítač je klient i server) umožňuje sdílení paměti vyrovnávací paměti pro vyrovnávací paměť rámce mezi relacemi. |
| EnableHardwareMode | VT_BOOL | Pouze zápis | Ne | Pokud true, hardware pomáhá s dekódováním grafiky. |
| IgnoreCursors | VT_BOOL | Pouze zápis | Ne | Pokud true, kurzory odeslané vzdáleným serverem budou ignorovány. |
| ManualClipboardSyncEnabled | VT_BOOL | Čtení a zápis | Ano | Nastavení této vlastnosti na hodnotu True znamená, že místní a vzdálené schránky nebudou automaticky synchronizovány. Místo IMsRdpClipboard rozhraní musí být použito k synchronizaci formátů schránky z místní schránky do vzdálené schránky a vzdálené schránky do místní schránky. |
| ZoomLevel | * VT_UI4 | Čtení a zápis | Ano | Implementuje funkci Lupa pomocí ovládacího prvku ActiveX protokolu RDP. Funkce Lupa je k dispozici v nabídce Systém protokolu RDP. Vlastnost ZoomLevel nemá žádný vliv v režimu RemoteAppu a v režimu zobrazení na celé obrazovce. IMsRdpClientAdvancedSettings::SmartSizing a ZoomLevel se vzájemně vylučují. |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | Ne | Pokud True, způsobí to, že připojení RemoteAppu se vrátí ke staršímu jazykovému panelu před Windows 8 místo automatické synchronizace místního jazyka do vzdálené relace. |
| RedirectTextProcessing | VT_BOOL | W | Ne | Počínaje Windows 11 23H2 povolí nebo zakáže přesměrování zpracování textu, které poskytuje podobné prostředí pro scénáře zadávání textu, například IME, emotikony. |
| HvSocketServiceId | VT_BSTR | W | Ne | Určuje pole ServiceId Hyper-V soketuadresy, kde se má odesílat provoz protokolu RDP. |
| DeviceScaleFactor | VT_UI4 | R/W | Ne | Určuje faktor škálování zařízení použitý ve vzdálené relaci. Platné hodnoty: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Ne | Povolí nebo zakáže přesměrování umístění místního počítače do vzdálené relace. |
| AudioCaptureDevice | VT_BSTR | R/W | Ne | Určuje ID zařízení zvukového zachytávání, které se má přesměrovat z klienta do vzdálené relace. Aplikace můžou pomocí zprávy DRV_QUERYFUNCTIONINSTANCEID určit ID zařízení zvukového záznamu, které se má přesměrovat. Případně můžete nastavit výchozí nastavení tak, aby se k zakázání zvukového záznamu použilo výchozí zařízení nebo žádné. Ve výchozím nastavení je tato možnost nastavená na výchozí. |
| RailMode | VT_BOOL | R | Ne | Udává, jestli se jedná o připojení RemoteAppu. ITSRemoteProgram::RemoteProgramMode zapisovat do této vlastnosti. |
| EnableRdsAadAuth | VT_BOOL | W | Ne | Pokud |
| RDGIsKDCProxy | VT_BOOL | W | Ne | Pokud true, informuje klienta, aby jako proxy server služby KDC používal bránu VP (pokud je zadána). |
| UseURCP | VT_BOOL | R/W | Ne | Pokud True, tato vlastnost povolí protokol Universal Rate Control Protocol pro připojení ke vzdálené ploše založené na protokolu UDP. V současné době je ve výchozím nastavení zakázaný. Povolení, pokud se používá UDP, doporučujeme. |
| DesktopScaleFactor | VT_UI4 | R/W | Ne | Určuje faktor škálování zařízení použitý ve vzdálené relaci. Hodnota by měla být mezi 100 a 500 (procenty). |
| RedirectedAuthentication | VT_BOOL | W | Ne | Pokud true, remote credential Guard je povolená. |
| RestrictedLogon | VT_BOOL | W | Ne | Pokud true, režim Restricted Admin povoleno. |
| AudioPlaybackDevice | VT_BSTR | R/W | Ne | Určuje ID zařízení zařízení pro přehrávání zvuku na místním počítači. Aplikace můžou pomocí zprávy DRV_QUERYFUNCTIONINSTANCEID určit ID zařízení zařízení pro přehrávání zvuku, které se má přesměrovat. Pokud chcete zakázat přehrávání zvuku, můžete ho také nastavit na výchozí. Ve výchozím nastavení je tato možnost nastavená na výchozí. " |
| SelectedMonitors | VT_BSTR | R/W | Ne | Seznam ID monitorování oddělený čárkami nebo oddělený středníkem, který identifikuje vybrané monitory, kde se má vzdálená relace zobrazit. První ID v seznamu bude považováno za primární monitor ve vzdálené relaci. |
| WslgModeEnabled | VT_BOOL | W | Ne | Pokud true, relace je relace WSLg relace. Očekává se, že budou poskytnuty následující vlastnosti:
Projděte si dokumentaci WSLg https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Ano | Zápis True do této vlastnosti okamžitě zobrazí dialogové okno s podrobnými informacemi o vzdálené relaci. Tato vlastnost je určená jako mechanismus ladění. Může se změnit a odebrat. |
| PrintProgressMode | VT_UI4 | R/W | Ne | Možné hodnoty:
|
| Id korelace | VT_BOOL | W | Ne | Přepíše hodnotu vrácenou IMsRdpClientNonScriptable8::CorrelationId. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Ne | Pokud true, vzdálená relace se zobrazí pouze pomocí DirectX bez návratu do GDI. Tato vlastnost se nevztahuje na vzdálené relace aplikací. Poznámka: Tato vlastnost je předmětem odebrání v budoucích verzích Systému Windows, protože režim pouze DirectX může být jedinou dostupnou možností. Toto je aktuálně funkce Preview, která by neměla být povolena v produkčním kódu. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Ne | Tato vlastnost se už nepodporuje. V budoucích verzích Windows se může odebrat. Tuto vlastnost nepoužívejte. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Ne | Pokud True a ServerSupportsEdgeActions vlastnost je True, další příkazy se zobrazí na panelu nástrojů připojení vzdálené relace. |
| TSGTransportIsUsed | VT_BOOL | R | Není k dispozici | Pokud true, brána vzdálené plochy se používá pro přidruženou vzdálenou relaci. |
| DiagnosticsInfo | VT_BSTR | W | Ne | Hexadecimální řetězec představující rdpCorrelationInfo.correlationId pole Client X.224 Žádost o připojení PDU. |
| EndpointFedAuth | VT_BSTR | W | Ne | Token používaný pro federované ověřování RDSTLS na základě deklarací identity. |
| AllowAxToContainerEvents | VT_BOOL | W | Ne | Tato vlastnost byla přidána ve Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | Není k dispozici | Vlastnost jen pro čtení k určení, zda vzdálená relace má RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 schopnost https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411. |
| AppContainerID | VT_BSTR | W | Ne | ID AppContainer předané IWorkspaceScriptable3::StartWorkspaceEx2 při IMsRdpClientNonScriptable8::StartWorkspaceExtension je vyvolána. Poznámka: Ovládací panel Připojení ke vzdálené ploše už není aktivní ve vývoji. Může být změněn nebo nedostupný v budoucích verzích Windows. Použití tohoto rozhraní API se nedoporučuje. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Ne | Pokud true, pohyb myši vygenerovaný programově ve vzdálené relaci se ignoruje. Přesněji řečeno, aktualizace pozice ukazatele pdU se nepoužije. Viz https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Ne | Tato vlastnost se už nepodporuje. V budoucích verzích Windows se může odebrat. Tuto vlastnost nepoužívejte. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Ne | Pokud true, při synchronizaci konfigurací zobrazení se do vzdálené relace odesílají rozšířené informace o monitorování (např. EDID). |
| ID pracovního prostoru | VT_BSTR | W | Ne | Jedinečný identifikátor připojení v aplikaci RemoteApp a Připojení k ploše, do které vzdálená relace patří. |
| ShowConnectionInformation | VT_BOOL | W | Ano | Při zápisu True do této vlastnosti se zobrazí dialogové okno Informace o připojení. |
| WslgSharedMemoryPath | VT_BSTR | W | Ne | Cesta k objektu relace paměti ke sdílení grafické vyrovnávací paměti s virtuálním počítačem WSLg. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Ne | Identifikátor GUID přidružený ke spuštěném virtuálnímu počítači, který je hostitelem vzdálené aplikace. Zápis této vlastnosti vede ke zlepšení výkonu vzdálených aplikací spuštěných na místním virtuálním počítači kvůli sdílení paměti. |
| KDCProxyName | VT_BSTR | W | Ne | Určuje plně kvalifikovaný název domény proxy serveru KDC (Key Distribution Center). Proxy KDC umožňuje klientovi RDP používat ověřovací protokol Kerberos, pokud nemá přímý přístup k KDC. Příklad hodnoty vlastnosti: ""kdc.contoso.com". Další informace najdete v tématu: Konfigurace proxy serveru služby Kerberos Key Distribution Center, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | Ne | Pokud True, gesta na vícedotykových obrazovkách se na vzdálený server neodesílají. Ve výchozím nastavení je nastavena na hodnotu false. |
| HvSocketEnabled | VT_BOOL | W | Ne | Pokud true, název vzdáleného serveru, pokud je identifikátor GUID, je interpretován jako pole VmId adresy soketu Hyper-V, kde se má odesílat provoz RDP. Ve výchozím nastavení je nastavena na hodnotu false. Další informace o adresách soketů Hyper-V najdete v tématu Vytvoření vazby k Hyper-V soketu. |
| MultipenRemotingSupported | VT_BOOL | W | Ne | Pokud True, je v vzdálené relaci podporováno souběžné vkládání vstupu z až čtyř zařízení pera. Ve výchozím nastavení je nastavena na hodnotu false. |
| ShowGatewayInformation | VT_BOOL | W | Ano | Zápis True do této vlastnosti zobrazuje dialogové okno s informacemi o bráně vzdálené plochy. Windows 11 22H2 a vyšší: tato vlastnost již není podporována a byla nahrazena vlastností ShowConnectionInformation. |
| DisableAutoReconnectComponent | VT_BOOL | W | Ne | Pokud True, připojení k serveru se při změně konfigurace sítě automaticky neodpojí a znovu se připojí. Ve výchozím nastavení je nastavena na hodnotu false. |
| RedirectUsbDrive | VT_UI4 | R/W | Ne | Představeno ve Windows 11 verze 24H2. Pokud není nastavena nebo nastavena na hodnotu 0, usb kryptografický disk se přesměruje jako směr jednotky. Když je nastavená hodnota 1, všechny usb kryptografický disky se přesměrují automaticky jako zařízení USB. Pokud je nastavená hodnota 2, jsou jednotky USB uvedené jako zařízení USB, uživatelé se můžou rozhodnout, že je přesměrují přes USB z uživatelského rozhraní (dialogové okno zařízení na panelu připojení) nebo položku souboru RDP "UsbDevicesToRedirect". |
| povolené protokoly zabezpečení | VT_BSTR | W | Ne | Představeno ve Windows 11 verze 24H2. Tato vlastnost slouží k omezení seznamu protokolů zabezpečení, které klient může vyjednat. Skutečný seznam vyjednaných protokolů je určen jinými nastaveními konfigurace a scénářem připojení a může být menší než seznam zadaný v této vlastnosti. Hodnota musí obsahovat seznam názvů protokolů oddělených písmenem ;, nebo může být hodnota nastavena na "", což znamená, že jsou povoleny všechny normálně vyjednané protokoly. Podporované názvy protokolů jsou: TLS, CredSSP, RDSTLS a RDS AAD Auth. Výchozí hodnota je. |
| AllowRelativeMouseMode | VT_BOOL | R/W | Ne | Představeno ve Windows 11 verze 24H2. Pokud je pravda, pohyby myši jsou reprezentovány vzhledem k aktuální pozici myši. |
| RemoteAppMouseMoveInject | VT_BOOL | W | Ne | Představeno ve Windows 11 verze 24H2. Zápis true do této vlastnosti vynutí vložení myši pohyb, když kurzor opustí okno RemoteAppu. Jedná se o alternativní řešení chyby popisu. |
Požadavky
| Požadavek | Hodnota |
|---|---|
| Minimální podporovaný klient |
Windows 8 |
| Minimální podporovaný server |
Windows Server 2012 |
| Knihovna typů |
|
| Knihovna dll |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting je definován jako 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting je definován jako A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting je definován jako 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings je definováno jako 302D8188-0052-4807-806A-362B628F9AC5 |