Свойство 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. Ожидается, что будут предоставлены следующие свойства:
Ознакомьтесь с документацией https://github.com/microsoft/wslgWSLg. |
| ShowSessionDiagnostics | VT_BOOL | Ж | Да | Запись True в это свойство сразу же отображает диалоговое окно с подробными сведениями о удаленном сеансе. Это свойство должно быть механизмом отладки. Он подлежит изменению и удалению. |
| PrintingProgressMode | VT_UI4 | R/W | Без | Возможные значения:
|
| 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.
|
| 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 |
| Библиотека типов |
|
| 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 |