Поделиться через


Свойство IMsRdpExtended Параметры::P roperty

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

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

Синтаксис

HRESULT put_Property(
  [in]          BSTR    bstrPropertyName,
  [in]          VARIANT *pValue
);

HRESULT get_Property(
  [in]          BSTR    bstrPropertyName,
  [out, retval] VARIANT *pValue
);

Значение свойства

Именованное значение свойства.

Имя свойства Тип данных Открыть Можно изменить после запуска подключения Description
Подключение ToChildSession VT_BOOL Чтение и запись Да Установка этого свойства в значение True приводит к подключению клиентского элемента управления к дочернему сеансу на локальном компьютере вместо удаленного сервера. Если это свойство имеет значение true, подключение к удаленному серверу невозможно, так как все подключения перенаправляются в localhost. Дополнительные сведения о дочерних сеансах см. в разделе "Дочерние сеансы".
DisableCredentialsDelegation VT_BOOL Чтение и запись No Если значение True, учетные данные не отправляются на удаленный сервер.
EnableFrameBufferRedirection VT_BOOL Чтение и запись No Если значение True, выполняется попытка перенаправления буфера кадра. Для подключения к циклу (один и тот же компьютер является клиентским и серверным) перенаправление буфера кадров позволяет использовать память буфера кадров между сеансами.
EnableHardwareMode VT_BOOL Только запись No Если значение True, выполняется попытка аппаратного обеспечения с декодированием графики.
IgnoreCursors VT_BOOL Только запись No Если значение True, курсоры, отправленные удаленным сервером, игнорируются.
ManualClipboardSyncEnabled VT_BOOL Чтение и запись Да При задании этого свойства значение True означает, что локальные и удаленные буферы обмена не будут автоматически храниться в синхронизации. Вместо этого интерфейс IMsRdpClipboard должен использоваться для синхронизации форматов буфера обмена с локального буфера обмена с удаленным буфером обмена и удаленным буфером обмена с локальным буфером обмена.
ZoomLevel *VT_UI4 Чтение и запись Да Реализует функцию масштабирования с помощью элемента управления ActiveX RDP. Функция масштабирования доступна в системной меню RDP. Свойство ZoomLevel не действует в режиме RemoteApp и полноэкранном режиме. IMsRdpClientAdvanced Параметры::SmartSizing и ZoomLevel являются взаимоисключающими.
DisableSeamlessLanguageBar VT_BOOL R/W Без Если значение true, это приводит к отменить изменения подключения RemoteApp к устаревшей языковой строке до Windows 8, а не автоматически синхронизирует локальный язык с удаленным сеансом. 
RedirectTextProcessing VT_BOOL Ж Без Начиная с Windows 11 23H2, включает или отключает перенаправление обработки текста, которая предоставляет подобный локальный интерфейс для сценариев ввода текста, например IME, смайликов. 
HvSocketServiceId VT_BSTR Ж Без Указывает поле 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 Ж Без Если значение true, используется безопасность проверки подлинности AAD AAD. 
RDGIsKDCProxy VT_BOOL Ж Без Значение True указывает клиенту использовать шлюз удаленных рабочих столов (если указано) в качестве прокси-сервера KDC. 
UseURCP VT_BOOL R/W Без Если значение true, это свойство включает протокол универсального управления скоростью для подключений удаленного рабочего стола на основе UDP. В настоящее время он отключен по умолчанию. Включите его, если UDP используется, рекомендуется. 
DesktopScaleFactor VT_UI4 R/W Без Указывает коэффициент масштабирования устройства, используемый в удаленном сеансе. Значение должно составлять от 100 до 500 (процент). 
ПеренаправлениеAuthentication VT_BOOL Ж Без Если задано значение True, функция Remote Credential Guard включена. 
RestrictedLogon VT_BOOL Ж Без Если значение true, режим ограниченного Администратор включен. 
AudioPlaybackDevice VT_BSTR R/W Без Указывает идентификатор устройства воспроизведения звука на локальном компьютере.
Приложения могут использовать сообщение DRV_QUERYFUNCTIONINSTANCEID для определения идентификатора устройства воспроизведения звука для перенаправления.
Кроме того, для отключения воспроизведения звука можно задать значение "по умолчанию" для использования устройства по умолчанию или "none". По умолчанию это значение имеет значение ""default". "
SelectedMonitors VT_BSTR R/W Без Список с разделителями-запятыми или полуколонок с разделителями монитора, чтобы определить выбранные мониторы, где будет отображаться удаленный сеанс. Первый идентификатор в списке будет рассматриваться как основной монитор в удаленном сеансе. 
WslgModeEnabled VT_BOOL Ж Без Если значение true, сеанс является сеансом WSLg.
Ожидается, что будут предоставлены следующие свойства:
  • WslgSharedMemoryPath
  • HvSocketEnabled
  • HvSocketServiceId

Ознакомьтесь с документацией https://github.com/microsoft/wslgWSLg.
ShowSessionDiagnostics VT_BOOL Ж Да Запись True в это свойство сразу же отображает диалоговое окно с подробными сведениями о удаленном сеансе.
Это свойство должно быть механизмом отладки. Он подлежит изменению и удалению. 
PrintingProgressMode VT_UI4 R/W Без Возможные значения:
  • 0: диалоговое окно хода выполнения, отображаемое при отключении печати
  • 1. Диалоговое окно выполнения, отображаемое при печати, содержит основные сведения
  • 2. Диалоговое окно выполнения, отображаемое при печати, содержит подробные сведения
Correlationid VT_BOOL Ж Без Переопределяет значение, возвращаемое IMsRdpClientNonScriptable8::CorrelationId. 
RequestUseNewOutputPresenter VT_BOOL Ж Без Если значение True, удаленный сеанс представлен только с помощью DirectX без резервного размещения в GDI. Это свойство не применяется к удаленным сеансам приложений.
Примечание. Это свойство подлежит удалению в будущих версиях Windows, так как режим только DirectX может стать единственным доступным вариантом. В настоящее время это функция предварительной версии, которая не должна быть включена в рабочем коде.
GatewayCertificateLogonAuthority VT_BSTR Ж Без Это свойство больше не поддерживается. Он подлежит удалению в будущих версиях Windows. Не используйте данное свойство. 
EnableRemoteEdgeBar VT_BOOL R/W Без Если значение True и свойство ServerSupportsEdgeActions имеет значение True, на панели инструментов подключения удаленного сеанса отображаются дополнительные команды. 
TSGTransportIsUsed VT_BOOL R N/A Если значение true, шлюз удаленных рабочих столов используется для связанного удаленного сеанса. 
DiagnosticsInfo VT_BSTR Ж Без Шестнадцатеричная строка, представляющая поле rdpCorrelationInfo.correlationId клиента X.224 Подключение ion Request PDU
EndpointFedAuth VT_BSTR Ж Без Маркер, используемый для федеративной проверки подлинности RDSTLS на основе утверждений
AllowAxToContainerEvents VT_BOOL Ж Без Это свойство было добавлено в Windows 11 22H2.
  • Если значение False (поведение по умолчанию, начиная с Windows 11 22H2), сочетания клавиш CTRL+ALT+ARROW отправляются в удаленный сеанс.
  • Если значение True (поведение по умолчанию до Windows 11 22H2), сочетания клавиш CTRL+ALT+СТРЕЛКА вызывают событие IMsTscAxEvents::OnFocusReleased в приложение.
ServerSupportsEdgeActions VT_BOOL R N/A Свойство только для чтения, чтобы определить, имеет ли удаленный сеанс возможность https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1
AppContainerID VT_BSTR Ж Без Идентификатор AppContainer, передаваемый в IWorkspaceScriptable3::StartWorkspaceEx2 при вызове IMsMsRdpClientNonScriptable8::StartWorkspaceExtension .
Примечание. Панель управления remoteApp и desktop Подключение ions больше не находится в активной разработке. Он может быть изменен или недоступен в будущих версиях 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 Ж Без Это свойство больше не поддерживается. Он подлежит удалению в будущих версиях Windows. Не используйте данное свойство. 
EnableVailMonitorConfig VT_BOOL R/W Без Если значение True, то расширенные сведения монитора (например, EDID) отправляются в удаленный сеанс при синхронизации конфигураций отображения. 
Идентификатор рабочей области VT_BSTR Ж Без Уникальный идентификатор подключения в RemoteApp и desktop Подключение ions, к которому принадлежит удаленный сеанс. 
Show Подключение ionInformation VT_BOOL Ж Да В этом свойстве отображается диалоговое окно сведений о Подключение ion Information. 
WslgSharedMemoryPath VT_BSTR Ж Без Путь к объекту сеанса памяти для совместного использования графического буфера с виртуальной машиной WSLg. 
HiDefRemoteAppContainerGUID VT_BSTR Ж Без GUID, связанный с работающей виртуальной машиной, в котором размещается удаленное приложение. Написание этого свойства приводит к повышению производительности удаленных приложений, работающих на локальной виртуальной машине из-за общего доступа к памяти. 
KDCProxyName VT_BSTR Ж Без "Указывает полное доменное имя прокси-сервера Центра распространения ключей (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 Ж Без Если значение True, имя удаленного сервера, если это GUID, интерпретируется как поле VmId адреса сокета Hyper-V, в котором отправляется трафик RDP. По умолчанию для этого параметра задано значение False.
Дополнительные сведения об адресах сокета Hyper-V см. в статье "Привязка к сокету Hyper-V". 
MultipenRemotingSupported VT_BOOL Ж Без Если значение True, в удаленном сеансе поддерживается одновременное внедрение входных данных с до четырех устройств пера. По умолчанию для этого параметра задано значение False
ShowGatewayInformation VT_BOOL Ж Да Запись True в этом свойстве показывает диалоговое окно со сведениями о шлюзе удаленных рабочих столов.
Windows 11 22H2 и выше: это свойство больше не поддерживается и заменено свойством Show Подключение ionInformation.

Требования

Требование Значение
Минимальная версия клиента
Windows 8
Минимальная версия сервера
Windows Server 2012
Библиотека типов
Mstscax.dll
DLL-библиотеки
Mstscax.dll
CLSID
CLSID_MsRdpClient7NotСейф ForScripting определяется как 54d38bf7-b1ef-4479-9674-1bd6ea46ea465258
CLSID_MsRdpClient8NotСейф ForScripting определяется как A3BC03A0-041D-42E3-AD22-882B7865C9C5
CLSID_MsRdpClient9NotСейф ForScripting определяется как 8B918B82-7985-4C24-89DF-C33AD2BBFBCD
IID
IID_IMsRdpExtendedПараметры определяется как 302D8188-0052-4807-806A-362B628F9AC5

См. также

IMsRdpExtended Параметры