Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Содержит именованное свойство.
Это свойство является чтением и записью.
Синтаксис
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Значение свойства
Именованное значение свойства.
| Имя свойства | Тип данных | Доступ | Можно изменить после запуска подключения | Описание |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Чтение и запись | Да | Установка этого свойства на True приводит к подключению клиентского элемента управления к дочернему сеансу на локальном компьютере вместо удаленного сервера. Если для этого свойства задано значение true, подключение к удаленному серверу невозможно, так как все подключения перенаправляются в localhost. Дополнительные сведения о дочерних сеансах см. в дочерних сеансов. |
| DisableCredentialsDelegation | VT_BOOL | Чтение и запись | Нет | Если True, учетные данные не отправляются на удаленный сервер. |
| EnableFrameBufferRedirection | VT_BOOL | Чтение и запись | Нет | Если True, выполняется попытка перенаправления буфера кадров. Для подключения к циклу (один и тот же компьютер является клиентским и серверным) перенаправление буфера кадров позволяет использовать память буфера кадров между сеансами. |
| EnableHardwareMode | VT_BOOL | Только запись | Нет | Если True, выполняется попытка аппаратного обеспечения с декодированием графики. |
| IgnoreCursors | VT_BOOL | Только запись | Нет | Если Trueкурсоры, отправленные удаленным сервером, игнорируются. |
| ManualClipboardSyncEnabled | VT_BOOL | Чтение и запись | Да | При задании этого свойства значение True означает, что локальные и удаленные буферы обмена не будут автоматически храниться в синхронизации. Вместо этого интерфейс IMsRdpClipboard должен использоваться для синхронизации форматов буфера обмена с локального буфера обмена с удаленным буфером обмена и удаленного буфера обмена с локальным буфером обмена. |
| ZoomLevel | * VT_UI4 | Чтение и запись | Да | Реализует функцию масштабирования с помощью элемента управления ActiveX RDP. Функция масштабирования доступна в меню System RDP. Свойство ZoomLe vel не действует в режиме RemoteApp и полноэкранном режиме. IMsRdpClientAdvancedSettings::SmartSizing и ZoomLevel являются взаимоисключающими. |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | Нет | Если True, это приводит к тому, что подключения RemoteApp будут возвращаться к устаревшей строке языков до Windows 8, а не автоматически синхронизируть локальный язык с удаленным сеансом. |
| RedirectTextProcessing | VT_BOOL | W | Нет | Начиная с Windows 11 23H2, включает или отключает перенаправление обработки текста, которая предоставляет подобный локальный интерфейс для сценариев ввода текста, например IME, смайликов. |
| HvSocketServiceId | VT_BSTR | W | Нет | Задает поле ServiceId для сокета Hyper-V, в котором отправляется трафик RDP. |
| DeviceScaleFactor | VT_UI4 | R/W | Нет | Указывает коэффициент масштабирования устройства , используемый в удаленном сеансе. Допустимые значения: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | Нет | Включает или отключает перенаправление расположения локального компьютера на удаленный сеанс. |
| AudioCaptureDevice | VT_BSTR | R/W | Нет | Указывает идентификатор устройства записи звука для перенаправления от клиента к удаленному сеансу. Приложения могут использовать сообщение DRV_QUERYFUNCTIONINSTANCEID для определения идентификатора устройства записи звука для перенаправления. Кроме того, можно задать значение default, чтобы использовать устройство по умолчанию или "нет", чтобы отключить звукозапись. По умолчанию для этого параметра задано значение default. |
| RailMode | VT_BOOL | R | Нет | Сообщает, является ли это подключение RemoteApp. ITSRemoteProgram::RemoteProgramMode записывает в это свойство. |
| EnableRdsAadAuth | VT_BOOL | W | Нет | Если true, используется безопасности RDS AAD. |
| RDGIsKDCProxy | VT_BOOL | W | Нет | Если true, клиент будет использовать шлюз удаленных рабочих столов (если указано) в качестве прокси-сервера KDC. |
| UseURCP | VT_BOOL | R/W | Нет | Если True, это свойство включает протокол универсального управления скоростью для подключений Remote Desktop на основе UDP. В настоящее время он отключен по умолчанию. Включите его, если UDP используется, рекомендуется. |
| DesktopScaleFactor | VT_UI4 | R/W | Нет | Указывает коэффициент масштабирования устройства , используемый в удаленном сеансе. Значение должно составлять от 100 до 500 (процент). |
| ПеренаправлениеAuthentication | VT_BOOL | W | Нет | Если true, включена Remote Credential Guard. |
| RestrictedLogon | VT_BOOL | W | Нет | Если true, режим ограниченного администрирования включен. |
| AudioPlaybackDevice | VT_BSTR | R/W | Нет | Указывает идентификатор устройства воспроизведения звука на локальном компьютере. Приложения могут использовать сообщение DRV_QUERYFUNCTIONINSTANCEID для определения идентификатора устройства воспроизведения звука для перенаправления. Кроме того, для отключения воспроизведения звука можно задать значение "по умолчанию" для использования устройства по умолчанию или "none". По умолчанию это значение имеет значение ""default". " |
| SelectedMonitors | VT_BSTR | R/W | Нет | Список с разделителями-запятыми или полуколонок с разделителями монитора, чтобы определить выбранные мониторы, где будет отображаться удаленный сеанс. Первый идентификатор в списке будет рассматриваться как основной монитор в удаленном сеансе. |
| WslgModeEnabled | VT_BOOL | W | Нет | Если true, сеанс является сеансом WSLg. Ожидается, что будут предоставлены следующие свойства:
См. документацию WSLg https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Да | Запись True в это свойство сразу же отображает диалоговое окно с подробными сведениями о удаленном сеансе. Это свойство должно быть механизмом отладки. Он подлежит изменению и удалению. |
| PrintingProgressMode | VT_UI4 | R/W | Нет | Возможные значения:
|
| CorrelationId | VT_BOOL | W | Нет | Переопределяет значение, возвращаемое IMsRdpClientNonScriptable8::CorrelationId. |
| RequestUseNewOutputPresenter | VT_BOOL | W | Нет | Если True, удаленный сеанс представлен только с помощью DirectX без резервного использования GDI. Это свойство не применяется к удаленным сеансам приложений. Примечание. Это свойство подлежит удалению в будущих версиях Windows, так как режим только DirectX может стать единственным доступным вариантом. В настоящее время это функция предварительной версии, которая не должна быть включена в рабочем коде. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | Нет | Это свойство больше не поддерживается. Он подлежит удалению в будущих версиях Windows. Не используйте это свойство. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | Нет | Если true и свойство ServerSupportsEdgeActions равно True, дополнительные команды отображаются на панели инструментов подключения удаленного сеанса. |
| TSGTransportIsUsed | VT_BOOL | R | N/A | Если True шлюз Remote Desktop используется для связанного удаленного сеанса. |
| DiagnosticsInfo | VT_BSTR | W | Нет | Шестнадцатеричная строка, представляющая поле rdpCorrelationInfo.correlationIdклиента X.224. |
| EndpointFedAuth | VT_BSTR | W | Нет | Маркер, используемый для федеративной проверки подлинности RDSTLSна основе утверждений. |
| AllowAxToContainerEvents | VT_BOOL | W | Нет | Это свойство было добавлено в Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | N/A | Свойство только для чтения, чтобы определить, имеет ли удаленный сеанс возможность RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411. |
| AppContainerID | VT_BSTR | W | Нет | Идентификатор AppContainer, переданный IWorkspaceScriptable3::StartWorkspaceEx2 при вызове IMsRdpClientNonScriptable8::StartWorkspaceExtension. Примечание. Панель управления подключениями к удаленному приложению и рабочему столу больше не находится в активной разработке. Он может быть изменен или недоступен в будущих версиях Windows. Использование этого API не рекомендуется. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | Нет | Если True, перемещение мыши, созданное программным способом в удаленном сеансе, игнорируется. Точнее, PDU с обновлением положения указателя не применяется. См. https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | Нет | Это свойство больше не поддерживается. Он подлежит удалению в будущих версиях Windows. Не используйте это свойство. |
| EnableVailMonitorConfig | VT_BOOL | R/W | Нет | Если True, расширенные сведения монитора (например, EDID) отправляются в удаленный сеанс при синхронизации конфигураций отображения. |
| Идентификатор рабочей области | VT_BSTR | W | Нет | Уникальный идентификатор подключения в подключения к удаленному приложению RemoteApp и рабочему столу, к которому принадлежит удаленный сеанс. |
| ShowConnectionInformation | VT_BOOL | W | Да | Запись true в это свойство отображает диалоговое окно "Сведения о подключении". |
| WslgSharedMemoryPath | VT_BSTR | W | Нет | Путь к объекту сеанса памяти для совместного использования графического буфера с виртуальной машиной WSLg. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | Нет | GUID, связанный с работающей виртуальной машиной, в котором размещается удаленное приложение. Написание этого свойства приводит к повышению производительности удаленных приложений, работающих на локальной виртуальной машине из-за общего доступа к памяти. |
| KDCProxyName | VT_BSTR | W | Нет | "Указывает полное доменное имя прокси-сервера Центра распространения ключей (KDC). Прокси-сервер KDC позволяет клиенту RDP использовать протокол проверки подлинности Kerberos, если он не может напрямую получить доступ к KDC. Пример значения свойства: ""kdc.contoso.com"". Дополнительные сведения см. в статье Настройка прокси-сервера Центра распространения ключей Kerberos, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | Нет | Если True, жесты на нескольких сенсорных экранах не будут отправляться на удаленный сервер. По умолчанию это значение равно False. |
| HvSocketEnabled | VT_BOOL | W | Нет | Если True, имя удаленного сервера, если это GUID, интерпретируется как поле VmId адреса сокета Hyper-V, в котором отправляется трафик RDP. По умолчанию это значение равно False. Дополнительные сведения об адресах сокета Hyper-V см. в Bind в сокете Hyper-V. |
| MultipenRemotingSupported | VT_BOOL | W | Нет | Если True, в удаленном сеансе поддерживается одновременная внедрение входных данных с до четырех устройств пера. По умолчанию это значение равно False. |
| ShowGatewayInformation | VT_BOOL | W | Да | Запись True в этом свойстве отображает диалоговое окно с информацией о шлюзе Remote Desktop. Windows 11 22H2 и выше: это свойство больше не поддерживается и заменено свойством ShowConnectionInformation. |
| DisableAutoReconnectComponent | VT_BOOL | W | Нет | Если true, подключение к серверу не будет отключено и повторно подключено автоматически при изменении конфигурации сети. По умолчанию это значение равно False. |
| RedirectUsbDrive | VT_UI4 | R/W | Нет | Представлено в Windows 11 версии 24H2. Если не задано значение 0, USB-диск перенаправляется в качестве направления диска. Если задано значение 1, все USB-накопители перенаправляются автоматически как USB-устройства. Если задано значение 2, USB-накопители отображаются как USB-устройства, пользователи могут перенаправить их через USB-перенаправление из пользовательского интерфейса (диалоговое окно устройства в строке подключения) или запись файла RDP "UsbDevicesToRedirect". |
| разрешенные протоколы безопасности | VT_BSTR | W | Нет | Представлено в Windows 11 версии 24H2. Это свойство используется для ограничения списка протоколов безопасности, которые клиент может согласовывать. Фактический список согласованных протоколов определяется другими параметрами конфигурации и сценарием подключения и может быть меньше списка, указанного в этом свойстве. Значение должно содержать список имен протоколов, разделенных ";", или значение может иметь значение "", что означает, что разрешены все обычно согласованные протоколы. Поддерживаемые имена протоколов: TLS, CredSSP, RDSTLS и RDSAD Auth по умолчанию — "". |
| AllowRelativeMouseMode | VT_BOOL | R/W | Нет | Представлено в Windows 11 версии 24H2. Если значение True, движения мыши представлены относительно текущей позиции мыши. |
| RemoteAppMouseMoveInject | VT_BOOL | W | Нет | Представлено в Windows 11 версии 24H2. Запись True в это свойство заставляет внедрение перемещения мыши при выходе курсора из окна RemoteApp. Это предназначено для обходного решения для ошибки подсказки. |
| EnableZoom | VT_BOOL | W | Нет | Запись True в это свойство позволяет пользователю масштабировать окно удаленного сеанса над собственным разрешением, а интеллектуальный размер активен. |
| SmartRawPrinters | VT_BSTR | R/W | Нет | Представлено в Windows 11 версии 26H1. Запись * в это свойство обеспечивает интеллектуальный режим печати для всех принтеров. При настройке его в префикс имени драйвера принтера включен режим только для принтеров, драйвер которых соответствует префиксу. Если включен режим интеллектуальной печати, клиент Remote Desktop использует необработанную печать для перенаправленного принтера всякий раз, когда сервер также использует необработанную печать для этого принтера. |
| RedirectionWarningDialogVersion | VT_UI4 | W | Нет | Указывает версию диалогового окна безопасности подключения, отображаемого до установки подключения. Значение по умолчанию — 2, в котором отображается новое диалоговое окно безопасности подключения, введенное с обновлением системы безопасности за апрель 2026 г. Запись 1 восстанавливает предыдущее поведение диалога. Если задано значение 2, следующие свойства не влияют: IMsRdpClientNonScriptable3::WarnAboutClipboardRedirection, IMsRdpClientNonScriptable3::WarnAboutSendingCredentials, IMsRdpClientNonScriptable4::WarnAboutPrinterRedirection и IMsRdpClientNonScriptable5::WarnAboutDirectXRedirection. |
| RemoteApplicationFile | VT_BSTR | W | Нет | Указывает путь к файлу удаленного приложения, показанный в диалоговом окне безопасности подключения версии 2. Это то же значение, которое будет передано в качестве параметра bstrFilePath в ITSRemoteProgram::ServerStartProgram после подключения. Так как диалоговое окно отображается до установки подключения, это свойство необходимо задать перед подключением. |
| RemoteApplicationAppID | VT_BSTR | W | Нет | Указывает идентификатор пользовательской модели приложения удаленного приложения, показанного в диалоговом окне безопасности подключения версии 2. Это то же значение, которое будет передано в качестве параметра bstrAppUserModelId объекта ITSRemoteProgram3::ServerStartApp после подключения. Так как диалоговое окно отображается до установки подключения, это свойство необходимо задать перед подключением. |
Требования
| Требование | Ценность |
|---|---|
| Минимальный поддерживаемый клиент |
Windows 8 |
| Минимальный поддерживаемый сервер |
Windows Server 2012 |
| Библиотека типов |
|
| Библиотека dll |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting определяется как 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting определяется как A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting определяется как 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings определен как 302D8188-0052-4807-806A-362B628F9AC5 |