IMsRdpExtendedSettings::P roperty, właściwość
Zawiera nazwaną właściwość.
Ta właściwość jest odczytywana/zapisywana.
Składnia
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Wartość właściwości
Nazwana wartość właściwości.
| Nazwa właściwości | Typ danych | Dostęp | Można zmienić po uruchomieniu połączenia | Opis |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Odczyt/zapis | Tak | Ustawienie tej właściwości na wartość True powoduje, że kontrolka klienta nawiązuje połączenie z sesją podrzędną na komputerze lokalnym zamiast zdalnego serwera. Jeśli ta właściwość jest ustawiona na wartość true, nie można nawiązać połączenia z serwerem zdalnym, ponieważ wszystkie połączenia są przekierowywane do hosta lokalnego. Aby uzyskać więcej informacji na temat sesji podrzędnych, zobacz Sesje podrzędne. |
| DisableCredentialsDelegation | VT_BOOL | Odczyt/zapis | Nie | Jeśli true, poświadczenia nie są wysyłane do serwera zdalnego. |
| EnableFrameBufferRedirection | VT_BOOL | Odczyt/zapis | Nie | Jeśli true, próba przekierowania buforu ramki zostanie podjęta. W przypadku połączenia sprzężenia zwrotnego (ten sam komputer jest zarówno klientem, jak i serwerem) przekierowanie buforu ramek umożliwia współdzielenie pamięci buforu ramki między sesjami. |
| EnableHardwareMode | VT_BOOL | Tylko zapis | Nie | Jeśli true, próba sprzętu pomaga w dekodowaniu grafiki. |
| IgnoreCursors | VT_BOOL | Tylko zapis | Nie | Jeśli true, kursory wysyłane przez serwer zdalny są ignorowane. |
| ManualClipboardSyncEnabled | VT_BOOL | Odczyt/zapis | Tak | Ustawienie tej właściwości na wartość True oznacza, że lokalne i zdalne schowki nie będą automatycznie synchronizowane. Zamiast tego interfejs IMsRdpClipboard musi być używany do synchronizowania formatów schowka z lokalnego schowka do schowka zdalnego i schowka zdalnego do lokalnego schowka. |
| ZoomLevel | * VT_UI4 | Odczyt/zapis | Tak | Implementuje funkcję Zoom przy użyciu kontrolki ActiveX protokołu RDP. Funkcja Zoom jest dostępna w menu System protokołu RDP. Właściwość ZoomLevel nie ma wpływu na tryb RemoteApp i tryb pełnoekranowy. IMsRdpClientAdvancedSettings::SmartSizing i ZoomLevel wzajemnie się wykluczają. |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | Nie | Jeśli true, spowoduje to przywrócenie starszego paska językowego z wcześniejszej wersji systemu Windows 8, a nie automatyczne synchronizowanie języka lokalnego z sesją zdalną. |
| RedirectTextProcessing | VT_BOOL | W | Nie | Począwszy od systemu Windows 11 23H2, włącza/wyłącza przekierowywanie przetwarzania tekstu, co zapewnia środowisko podobne do lokalnego dla scenariuszy wprowadzania tekstu, np. IME, emotikonów. |
| HvSocketServiceId | VT_BSTR | W | Nie | Określa pole ServiceId gniazda Hyper-Vadres, pod którym ma być wysyłany ruch RDP. |
| DeviceScaleFactor | VT_UI4 | R/W | Nie | Określa współczynnik skalowania urządzeń używany w sesji zdalnej. Prawidłowe wartości: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Nie | Włącza/wyłącza przekierowywanie lokalizacji komputera lokalnego do sesji zdalnej. |
| AudioCaptureDevice | VT_BSTR | R/W | Nie | Określa identyfikator urządzenia przechwytywania dźwięku do przekierowania z klienta do sesji zdalnej. Aplikacje mogą użyć komunikatu DRV_QUERYFUNCTIONINSTANCEID, aby określić identyfikator urządzenia przechwytywania dźwięku do przekierowania. Alternatywnie można to ustawić na wartość "default", aby użyć domyślnego urządzenia lub "brak", aby wyłączyć przechwytywanie dźwięku. Domyślnie jest to ustawienie "domyślne". |
| RailMode | VT_BOOL | R | Nie | Zgłasza, czy jest to połączenie usługi RemoteApp. ITSRemoteProgram::RemoteProgramMode zapisuje do tej właściwości. |
| EnableRdsAadAuth | VT_BOOL | W | Nie | Jeśli true, jest używany zabezpieczeń uwierzytelniania usługi AAD usług pulpitu zdalnego. |
| RDGIsKDCProxy | VT_BOOL | W | Nie | Jeśli true, informuje klienta o użyciu bramy usług pulpitu zdalnego (jeśli określono) jako serwera proxy usługi KDC. |
| UseURCP | VT_BOOL | R/W | Nie | Jeśli true, ta właściwość włącza protokół uniwersalnej kontroli szybkości dla połączeń pulpitu zdalnego opartych na protokole UDP. Obecnie jest ona domyślnie wyłączona. Włączenie go, jeśli protokół UDP jest w użyciu, jest zalecany. |
| DesktopScaleFactor | VT_UI4 | R/W | Nie | Określa współczynnik skalowania urządzeń używany w sesji zdalnej. Wartość powinna należeć do zakresu od 100 do 500 (procent). |
| Przekierowanie uwierzytelniania | VT_BOOL | W | Nie | Jeśli true, remote Credential Guard jest włączona. |
| Dziennik ograniczony | VT_BOOL | W | Nie | Jeśli true, tryb administratora z ograniczeniami jest włączony. |
| AudioPlaybackDevice | VT_BSTR | R/W | Nie | Określa identyfikator urządzenia odtwarzania audio na komputerze lokalnym. Aplikacje mogą użyć komunikatu DRV_QUERYFUNCTIONINSTANCEID, aby określić identyfikator urządzenia odtwarzania audio do przekierowania. "Alternatywnie można ustawić tę opcję na "domyślną", aby użyć domyślnego urządzenia lub "brak", aby wyłączyć odtwarzanie audio. Domyślnie jest to ustawienie "domyślne". " |
| SelectedMonitors (Wybranemonitory) | VT_BSTR | R/W | Nie | Rozdzielana przecinkami lub rozdzielana średnikami lista identyfikatora monitora w celu zidentyfikowania wybranych monitorów, gdzie ma być wyświetlana sesja zdalna. Pierwszy identyfikator na liście będzie traktowany jako monitor podstawowy w sesji zdalnej. |
| WslgModeEnabled | VT_BOOL | W | Nie | Jeśli true, sesja jest sesją WSLg. Powinny zostać podane następujące właściwości:
Zapoznaj się z dokumentacją usługi WSLg https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Tak | Zapisywanie true do tej właściwości natychmiast wyświetla okno dialogowe ze szczegółowymi informacjami na temat sesji zdalnej. Ta właściwość ma być mechanizmem debugowania. Może ulec zmianie i usunięciu. |
| DrukowanieProgressMode | VT_UI4 | R/W | Nie | Możliwe wartości:
|
| Identyfikator korelacji | VT_BOOL | W | Nie | Zastępuje wartość zwracaną przez IMsRdpClientNonScriptable8::CorrelationId. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Nie | Jeśli true, sesja zdalna jest wyświetlana przy użyciu funkcji DirectX tylko bez powrotu do interfejsu GDI. Ta właściwość nie ma zastosowania do sesji aplikacji zdalnych. Uwaga: ta właściwość podlega usunięciu w przyszłych wersjach systemu Windows, ponieważ tryb DirectX może stać się jedyną dostępną opcją. Jest to obecnie funkcja w wersji zapoznawczej, która nie powinna być włączona w kodzie produkcyjnym. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Nie | Ta właściwość nie jest już obsługiwana. Podlega on usunięciu w przyszłych wersjach systemu Windows. Nie używaj tej właściwości. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Nie | Jeśli true i ServerSupportsEdgeActions właściwość jest true, dodatkowe polecenia są wyświetlane na pasku narzędzi połączenia sesji zdalnej. |
| TSGTransportIsUsed | VT_BOOL | R | N/A | Jeśli true, brama usług pulpitu zdalnego jest używana dla skojarzonej sesji zdalnej. |
| DiagnosticsInfo | VT_BSTR | W | Nie | Ciąg szesnastkowy reprezentujący pole rdpCorrelationInfo.correlationId pola Client X.224 Connection Request PDU. |
| EndpointFedAuth | VT_BSTR | W | Nie | Token używany do uwierzytelniania federacyjnego opartego na oświadczeniach uwierzytelniania RDSTLS. |
| AllowAxToContainerEvents | VT_BOOL | W | Nie | Ta właściwość została dodana w systemie Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | N/A | Właściwość tylko do odczytu, aby określić, czy sesja zdalna ma RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 możliwości https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411. |
| AppContainerID | VT_BSTR | W | Nie | Identyfikator aplikacji AppContainer przekazany do interfejsu IWorkspaceScriptable3::StartWorkspaceEx2 po wywołaniu IMsRdpClientNonScriptable8::StartWorkspaceExtension. Uwaga: Panel sterowania Połączenia usługi RemoteApp i pulpitu nie jest już aktywny podczas opracowywania. Może zostać zmieniony lub niedostępny w przyszłych wersjach systemu Windows. Korzystanie z tego interfejsu API jest zniechęcane. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Nie | Jeśli true, ruch myszy wygenerowany programowo w sesji zdalnej jest ignorowany. Dokładniej mówiąc, nie zastosowano kontrolera PDU aktualizacji położenia wskaźnika. Zobacz https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Nie | Ta właściwość nie jest już obsługiwana. Podlega on usunięciu w przyszłych wersjach systemu Windows. Nie używaj tej właściwości. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Nie | Jeśli true, rozszerzone informacje o monitorze (np. identyfikatory EDID) są wysyłane do sesji zdalnej podczas synchronizowania konfiguracji wyświetlania. |
| Identyfikator obszaru roboczego | VT_BSTR | W | Nie | Unikatowy identyfikator połączenia w połączeniach usługi RemoteApp i połączeń pulpitu, do którego należy sesja zdalna. |
| ShowConnectionInformation | VT_BOOL | W | Tak | Zapisywanie true do tej właściwości powoduje wyświetlenie okna dialogowego Informacje o połączeniu. |
| WslgSharedMemoryPath | VT_BSTR | W | Nie | Ścieżka do obiektu sesji pamięci do udostępniania buforu graficznego maszynie wirtualnej WSLg. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Nie | Identyfikator GUID skojarzony z uruchomioną maszyną wirtualną hostujący aplikację zdalną. Napisanie tej właściwości powoduje zwiększenie wydajności aplikacji zdalnych działających na lokalnej maszynie wirtualnej z powodu udostępniania pamięci. |
| KDCProxyName | VT_BSTR | W | Nie | "Określa w pełni kwalifikowaną nazwę domeny serwera proxy centrum dystrybucji kluczy (KDC). Serwer proxy centrum dystrybucji kluczy umożliwia klientowi RDP używanie protokołu uwierzytelniania Kerberos, gdy nie może uzyskać bezpośredniego dostępu do centrum dystrybucji kluczy. Przykład wartości właściwości: ""kdc.contoso.com". Aby uzyskać więcej informacji, zobacz: Configure a Kerberos Key Distribution Center proxy, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | Nie | Jeśli true, gesty na ekranach wieloobsługowych nie będą wysyłane do serwera zdalnego. Domyślnie jest ona ustawiona na wartość False. |
| HvSocketEnabled | VT_BOOL | W | Nie | Jeśli true, nazwa serwera zdalnego, jeśli jest to identyfikator GUID, jest interpretowana jako pole VmId adresu gniazda Hyper-V, pod którym ma być wysyłany ruch RDP. Domyślnie jest ona ustawiona na wartość False. Aby uzyskać więcej informacji na temat adresów gniazd Hyper-V, zobacz Bind to a Hyper-V socket. |
| MultipenRemotingSupported | VT_BOOL | W | Nie | Jeśli true, jednoczesne wstrzykiwanie danych wejściowych z maksymalnie czterech urządzeń długopisowych jest obsługiwane w sesji zdalnej. Domyślnie jest ona ustawiona na wartość False. |
| ShowGatewayInformation | VT_BOOL | W | Tak | Zapisywanie true tej właściwości powoduje wyświetlenie okna dialogowego z informacjami o bramie usług pulpitu zdalnego. System Windows 11 22H2 lub nowszy: ta właściwość nie jest już obsługiwana i została zastąpiona właściwością ShowConnectionInformation. |
| DisableAutoReconnectComponent | VT_BOOL | W | Nie | Jeśli true, połączenie serwera nie zostanie rozłączone i ponownie połączone automatycznie po zmianie konfiguracji sieci. Domyślnie jest ona ustawiona na wartość False. |
| RedirectUsbDrive | VT_UI4 | R/W | Nie | Wprowadzono w systemie Windows 11 w wersji 24H2. Jeśli nie jest ustawiona lub ustawiona na 0, dysk kciuka USB przekierowuje jako kierunek dysku. Po ustawieniu wartości 1 wszystkie dyski kciuka USB są przekierowywane automatycznie jako urządzenia USB. Jeśli ustawiono wartość 2, dyski kciuka USB są wyświetlane jako urządzenia USB, użytkownicy mogą wybrać przekierowanie ich za pośrednictwem przekierowania USB z interfejsu użytkownika (okno dialogowe urządzenia na pasku połączenia) lub wpis pliku RDP "UsbDevicesToRedirect". |
| dozwolone protokoły zabezpieczeń | VT_BSTR | W | Nie | Wprowadzono w systemie Windows 11 w wersji 24H2. Ta właściwość służy do ograniczania listy protokołów zabezpieczeń, które klient może negocjować. Rzeczywista lista wynegocjowanych protokołów jest określana przez inne ustawienia konfiguracji i scenariusz połączenia i może być mniejsza niż lista określona w tej właściwości. Wartość musi zawierać listę nazw protokołów rozdzielonych znakami ";" lub wartość można ustawić na "", co oznacza, że wszystkie normalnie wynegocjowane protokoły są dozwolone. Obsługiwane nazwy protokołów to: "TLS", "CredSSP", "RDSTLS" i "RDS AAD Auth" Wartość domyślna to "". |
| AllowRelativeMouseMode | VT_BOOL | R/W | Nie | Wprowadzono w systemie Windows 11 w wersji 24H2. Jeśli to prawda, ruchy myszy są reprezentowane względem bieżącej pozycji myszy. |
| RemoteAppMouseMoveInject | VT_BOOL | W | Nie | Wprowadzono w systemie Windows 11 w wersji 24H2. Zapisywanie wartości True w tej właściwości wymusza wstrzyknięcie wskaźnika myszy, gdy kursor opuszcza okno usługi RemoteApp. Jest to obejście problemu dotyczącego usterki etykietki narzędzia. |
Wymagania
| Wymaganie | Wartość |
|---|---|
| Minimalny obsługiwany klient |
Windows 8 |
| Minimalny obsługiwany serwer |
Windows Server 2012 |
| Biblioteka typów |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting jest definiowana jako 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting jest definiowana jako A3BC03A0-041D-42E3-AD22-882B7865C9C9C5 CLSID_MsRdpClient9NotSafeForScripting jest definiowana jako 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| Identyfikator IID |
IID_IMsRdpExtendedSettings jest definiowana jako 302D8188-0052-4807-806A-362B628F9AC5 |