Свойство IMsRdpExtendedSettings::P roperty

Содержит именованное свойство.

Это свойство является чтением и записью.

Синтаксис

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, это свойство включает протокол универсального управления скоростью для подключений удаленного рабочего стола на основе 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. Ожидается, что будут предоставлены следующие свойства: WslgSharedMemoryPath HvSocketEnabled HvSocketServiceId См. документацию WSLg https://github.com/microsoft/wslg.
ShowSessionDiagnostics	VT_BOOL	W	Да	Запись True в это свойство сразу же отображает диалоговое окно с подробными сведениями о удаленном сеансе. Это свойство должно быть механизмом отладки. Он подлежит изменению и удалению.
PrintingProgressMode	VT_UI4	R/W	Нет	Возможные значения: 0: диалоговое окно хода выполнения, отображаемое при отключении печати 1. Диалоговое окно выполнения, отображаемое при печати, содержит основные сведения 2. Диалоговое окно выполнения, отображаемое при печати, содержит подробные сведения
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, шлюз удаленных рабочих столов используется для связанного удаленного сеанса.
DiagnosticsInfo	VT_BSTR	W	Нет	Шестнадцатеричная строка, представляющая поле rdpCorrelationInfo.correlationIdклиента X.224.
EndpointFedAuth	VT_BSTR	W	Нет	Маркер, используемый для федеративной проверки подлинности RDSTLSна основе утверждений.
AllowAxToContainerEvents	VT_BOOL	W	Нет	Это свойство было добавлено в Windows 11 22H2. Если false (поведение по умолчанию, начиная с Windows 11 22H2), сочетания клавиш CTRL+ALT+ARROW отправляются в удаленный сеанс. Если true (поведение по умолчанию до Windows 11 22H2), сочетания клавиш CTRL+ALT+СТРЕЛКА вызывают IMsTscAxEvents::OnFocusReleased событие в приложение.
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 см. в статье Привязка к Hyper-V сокету.
MultipenRemotingSupported	VT_BOOL	W	Нет	Если True, в удаленном сеансе поддерживается одновременная внедрение входных данных с до четырех устройств пера. По умолчанию это значение равно False.
ShowGatewayInformation	VT_BOOL	W	Да	Запись True в это свойство показывает диалоговое окно с информацией о шлюзе удаленных рабочих столов. 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. Это предназначено для обходного решения для ошибки подсказки.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 8
Минимальный поддерживаемый сервер	Windows Server 2012
Библиотека типов	MsTscAx.dll
Библиотека dll	MsTscAx.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

См. также

IMsRdpExtendedSettings