Метод IRDPSRAPISessionProperties::p ut_Property (rdpencomapi.h)

Статья
08/25/2023

Задает или получает именованное свойство сеанса.

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

Синтаксис

HRESULT put_Property(
  BSTR    PropertyName,
  VARIANT newVal
);

Параметры

PropertyName

newVal

Возвращаемое значение

None

Remarks

Вы можете задать и получить следующие свойства. Имена свойств чувствительны к регистру.

Имя свойства	Описание свойства	Тип значения
"DrvConAttach"	Примечание Свойство DrvConAttach больше не доступно для использования с Windows 10. Больше нет драйвера зеркало для общего доступа. Существует два режима для вложения драйвера зеркало. Первый — режим динамической загрузки. В этом режиме драйвер зеркало будет присоединен сразу после подключения участника к сеансу и управления представлением. Драйвер зеркало будет автоматически отсоединяться, когда последний участник покидает сеанс (или нет участников с контролем просмотра). Второй режим — статический режим загрузки. В этом режиме драйвер зеркало загружается сразу после открытия сеанса и не выгружается до завершения сеанса. Обратите внимание, что в обоих режимах драйвер может быть отключен и повторно подключен в результате внешних событий, таких как изменение разрешения экрана или глубина совместного использования цвета. Присвойте этому свойству значение VARIANT_TRUE для режима динамического вложения и VARIANT_FALSE для режима статического вложения. Обратите внимание, что это свойство можно задать только перед вызовом метода IRDPSRAPISharingSession::Open ; это свойство становится доступным только для чтения после вызова метода Open . Значение по умолчанию — VARIANT_TRUE. Для сценариев 1:1, таких как удаленный помощник, следует использовать режим динамической нагрузки, так как он может занять очень много времени между моментом открытия сеанса и моментом подключения эксперта. Для сценариев 1:M (многопартийный) следует использовать статический режим загрузки, так как подключение и отсоединение драйвера зеркало является весьма разрушительным и не должно выполняться, если нет веской причины.	VT_BOOL
"PortId"	Порт прослушивателя для входящих подключений из sharer. Это свойство также можно задать на стороне средства просмотра, но будет использоваться только для прослушивания подключений в случае обратного подключения.	VT_I4
"PortProtocol"	Указывает семейство протоколов для запуска прослушивателя в общем ресурсе. Возможны следующие значения: AF_UNSPEC Значение: 0 Семейство адресов не указано. AF_INET Значение: 2 Семейство адресов IPv4. AF_INET6 Значение: 23 Семейство адресов IPv6.	VT_I4
SetNetworkStream	Указатель на интерфейс IUnknown , поддерживающий интерфейс IRDPSRAPITransportStream . Если это свойство задано, метод Connect будет использовать этот поток и пропускать переданное строка подключения. Это свойство допустимо только на стороне средства просмотра.	VT_UNKNOWN
EnforceStrongEncryption	Если это свойство имеет значение VARIANT_TRUE, средство общего доступа требует, чтобы средство просмотра использовало шифрование, совместимое с FIPS 140. Значение по умолчанию — VARIANT_FALSE. Это свойство становится доступным только для чтения после вызова метода IRDPSRAPISharingSession::Open . Это свойство можно задать только перед вызовом этого метода. В Windows 10 версии 1709 добавлена поддержка средства просмотра для соответствия требованиям FIPS 140. Общий доступ отклоняет подключения из версий средства просмотра, предшествующих Windows 10 версии 1709. Это свойство допустимо только на стороне общего доступа.	VT_BOOL
"FrameCaptureIntervalInMs"	Задает интервал записи кадра. По умолчанию интервал записи кадра составляет 33 миллисекунда, что соответствует 30 кадрам в секунду. Это свойство можно использовать для оптимизации производительности. Если обновление экрана не требуется выполнять так часто, интервал записи можно увеличить. Например, значение 400 миллисекунд приводит к 2,5 кадрам в секунду. Это свойство допустимо только на стороне общего доступа.	VT_I4
DefaultAttendeeControlLevel	Задает уровень управления по умолчанию для участников. По умолчанию это значение равно CTRL_LEVEL_NONE (нет). Это значение можно изменить на CTRL_LEVEL_VIEW (представление). Уровень управления по умолчанию не может быть установлен как интерактивный. Это свойство допустимо только на стороне общего доступа.	VT_I4
"EnableClipboardRedirect"	Если это свойство имеет значение VARIANT_TRUE, активируется буфер обмена между средством обмена и средством просмотра. Значение по умолчанию — VARIANT_FALSE. Чтобы использовать общий доступ к буферу обмена, сеанс должен находиться в интерактивном режиме. Только одно подключение может совместно использовать буфер обмена. Подключение, которое недавно получило управление входными данными, использует общий доступ к буферу обмена. Общий доступ к буферу обмена для любого предыдущего подключения автоматически отключается. Это свойство можно использовать только для классических приложений. Это свойство допустимо только на стороне общего доступа. Это свойство доступно начиная с Windows 10 версии 1511.	VT_BOOL
SetClipboardRedirectCallback	Указывает указатель IUnknown на экземпляр IRDPSRAPIClipboardUseEvents , который получает обратный вызов при каждой попытке копирования с компьютера общего доступа в средство просмотра. Это свойство применимо только в том случае, если включен общий доступ к буферу обмена. Это свойство становится доступным только для чтения после вызова метода IRDPSRAPISharingSession::Open . Это свойство можно задать только перед вызовом этого метода. Это свойство можно использовать только для классических приложений. Это свойство допустимо только на стороне общего доступа. Это свойство доступно начиная с Windows 10 версии 1511.	VT_UNKNOWN
"EnabledTransports"	Указывает транспорты для включения. Значение 3 поддерживает как TCP, так и UDP. Значение по умолчанию — 1, то есть только TCP. Это свойство становится доступным только для чтения после вызова метода IRDPSRAPISharingSession::Open . Это свойство можно задать только перед вызовом этого метода. Это свойство доступно начиная с Windows 10 версии 1803. Это свойство допустимо только на стороне общего доступа.	VT_I4

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	rdpencomapi.h
DLL	RdpEncom.dll

См. также раздел

IRDPSRAPISessionProperties

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