Метод IRemoteDesktopClientSettings::SetRdpProperty (rdpappcontainerclient.h)

Задает значение одного именованного свойства RDP.

Синтаксис

HRESULT SetRdpProperty(
  [in] BSTR    propertyName,
  [in] VARIANT value
);

Параметры

[in] propertyName

Строка, задающая имя свойства.

Примечание Эти строковые значения не чувствительны к регистру.

 

Возможные значения: .

"административный сеанс" (логическое значение)

Указывает, является ли сеанс административным. Это может быть одно из следующих значений.

false

Сеанс не является административным.

True

Сеанс является административным.

"разрешить сглаживание шрифтов" (логическое значение)

Указывает, разрешено ли сглаживание шрифтов в удаленном сеансе. Это может быть одно из следующих значений.

false

Сглаживание шрифта не допускается.

True

Сглаживание шрифта разрешено.

"альтернативный полный адрес" (строка)

Указывает альтернативное имя или IP-адрес удаленного компьютера, к которому требуется подключиться.

"audiocapturemode" (Boolean)

Задает режим записи входных аудиоданных. Это может быть одно из следующих значений.

false

Не записывайте аудио входные данные.

True

Запись аудио входных данных.

"audiomode" (Number)

Указывает место воспроизведения звуков. Это может быть одно из следующих значений.

0

Воспроизведение звуков на клиентском компьютере.

1

Воспроизведение звуков на хост-компьютере.

2

Не воспроизводите звуки.

"уровень проверки подлинности" (число)

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

0

Нет.

1

Требуется проверка подлинности.

2

Проверка подлинности подлежит обсуждению.

3

Проверка подлинности не указана.

"тип подключения" (число)

Указывает тип подключения. Это может быть одно из следующих значений.

1

Modem (Модем)

2

Низкоскоростной широкополосный

3

Спутниковая

4

Высокоскоростной широкополосный

5

Глобальная сеть

6

Локальная сеть

7

Автоматическое обнаружение

"адрес сервера проверки подлинности на основе файлов cookie" (строка)

Указывает адрес сервера проверки подлинности на основе файлов cookie.

"desktopheight" (number)

Указывает высоту (в пикселях) виртуального рабочего стола.

"desktopwidth" (Number)

Указывает ширину (в пикселях) виртуального рабочего стола.

"Отключить перетаскивание полного окна" (логическое значение)

Указывает, отключено ли отображение содержимого окна при перетаскивании. Это может быть одно из следующих значений.

false

Активировано

True

Выключено

"disable menu anims" (Boolean)

Указывает, отключена ли анимация меню. Это может быть одно из следующих значений.

false

Активировано

True

Выключено

"отключить темы" (логическое значение)

Указывает, отключены ли темы. Это может быть одно из следующих значений.

false

Активировано

True

Выключено

"отключить обои" (логическое значение)

Указывает, отображаются ли обои. Это может быть одно из следующих значений.

false

Отображаются обои.

True

Обои не отображаются.

"domain" (String)

Указывает домен, используемый для подключения к удаленному сеансу.

"enablecredsspsupport" (Boolean)

Указывает, следует ли использовать проверку подлинности на основе CredSSP для удаленного сеанса. Это может быть одно из следующих значений.

false

Не используйте проверку подлинности на основе CredSSP.

True

Используйте проверку подлинности на основе CredSSP.

"full address" (String)

Указывает адрес компьютера, к которому выполняется подключение.

"gatewaycredentialssource" (Number)

Указывает источник учетных данных для шлюза удаленных рабочих столов. Это может быть одно из следующих значений.

0

Запросите у пользователя учетные данные и используйте проверку подлинности NTLM.

1

Используйте смарт-карта для учетных данных.

2

Используйте учетные данные для текущего пользователя, выполнившего вход.

3

Запросите у пользователя учетные данные и используйте обычную проверку подлинности.

4

Пользователь выберет источник учетных данных при входе в систему.

5

Используйте проверку подлинности на основе файлов cookie.

"gatewayhostname" (String)

Указывает имя сервера шлюза удаленных рабочих столов.

"gatewayprofileusagemethod" (Number)

Указывает использование профиля шлюза удаленных рабочих столов. Это может быть одно из следующих значений.

0

Используйте параметры профиля шлюза, если они есть.

1

Используйте явные параметры шлюза, даже если профиль шлюза существует.

"gatewayusagemethod" (Number)

Указывает использование шлюза удаленных рабочих столов. Это может быть одно из следующих значений.

0

Не используйте сервер шлюза удаленных рабочих столов. Флажок Обход сервера шлюза удаленных рабочих столов для локальных адресов проверка снят.

1

Используйте шлюз удаленных рабочих столов, заданный свойством gatewayhostname.

2

Автоматическое определение параметров сервера шлюза удаленных рабочих столов.

3

Используйте параметры по умолчанию Параметры использования шлюза удаленных рабочих столов.

4

Не используйте сервер шлюза удаленных рабочих столов. Установлен флажок Обход сервера шлюза удаленных рабочих столов для локальных адресов проверка.

"мышь с высоким разрешением" (логическое значение)

Задает режим разрешения для ввода с помощью мыши. Это может быть одно из следующих значений.

false

Входные данные с помощью мыши будут объединяться. Данные мыши будут подвыбраны и отправлены в соответствии с частотой выборки по умолчанию.

True

Ввод с помощью мыши не будет объединен. Данные мыши будут отправляться с полным разрешением.

"loadbalanceinfo" (String)

Содержит файл cookie для балансировки нагрузки, используемый для выбора оптимального сервера для клиентского компьютера.

"адрес веб-страницы входа" (строка)

Указывает адрес веб-страницы входа.

"Адрес сервера предварительной проверки подлинности" (строка)

Указывает адрес сервера предварительной проверки подлинности.

"prompt for credentials" (Boolean)

Указывает, будет ли пользователю предложено ввести свои учетные данные. Это может быть одно из следующих значений.

false

Пользователю не будет предложено ввести учетные данные.

True

Пользователю будет предложено ввести учетные данные.

"promptcredentialonce" (Number)

Указывает, включен ли общий доступ к учетным данным для шлюза удаленного рабочего стола. Это может быть одно из следующих значений.

0

Общий доступ к учетным данным отключен.

1

Общий доступ к учетным данным включен.

"redirectclipboard" (boolean)

Указывает, перенаправляется ли буфер обмена для клиента в удаленный сеанс. Это может быть одно из следующих значений.

false

Буфер обмена не перенаправляется.

True

Буфер обмена перенаправляется.

"redirectprinters" (boolean)

Указывает, перенаправляются ли принтеры клиента в удаленный сеанс. Это может быть одно из следующих значений.

false

Принтеры не перенаправляются.

True

Принтеры перенаправляются.

"требуется предварительная проверка подлинности" (номер)

Указывает, требуется ли предварительная проверка подлинности. Это может быть одно из следующих значений.

0

Предварительная проверка подлинности не требуется.

1

Требуется предварительная проверка подлинности.

"url-адрес поддержки" (строка)

Указывает URL-адрес для получения сведений о поддержке.

Boolean

use redirection server name (Boolean)

Указывает, разрешен ли сервер перенаправления. Это может быть одно из следующих значений.

false

Сервер перенаправления не разрешен.

True

Сервер перенаправления разрешен.

"имя пользователя" (строка)

Указывает имя пользователя, используемое для подключения к удаленному сеансу.

"WinRTEncryptedPassword" (String)

Указывает зашифрованный пароль. Чтобы задать это свойство, необходимо выполнить следующие действия.

1. Преобразуйте пароль с открытым текстом в двоичный с помощью метода ConvertStringToBinary в классе CryptographicBuffer .
2. Задайте свойство WinRTPasswordEncoding , используя эквивалентное значение для параметра кодирования, переданного методу ConvertStringToBinary на шаге 1.
3. Вызовите метод DataProtectionProvider(String), передав "LOCAL=user" для входной строки.
4. Вызовите метод ProtectAsync , чтобы зашифровать двоичную строку, содержащую пароль.
5. Преобразуйте объект CryptographicBuffer, возвращенный методом ProtectAsync , в значение в кодировке Base64 с помощью метода EncodeToBase64String .
6. Задайте это свойство (WinRTEncryptedPassword) с помощью строки в кодировке Base64, полученной на шаге 5.

"WinRTPasswordEncoding" (Number)

Указывает тип кодировки, которую можно применить к зашифрованным паролям. Это может быть одно из следующих значений. Значение по умолчанию — 1. Это свойство необходимо задать перед установкой свойства WinRTEncryptedPassword .

0

UTF8

1

UTF16LE

2

UTF16BE

"Идентификатор рабочей области" (строка)

Указывает идентификатор рабочей области RemoteApp и подключения к рабочему столу, частью которой был опубликован этот RDP-файл.

[in] value

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

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	rdpappcontainerclient.h
DLL	MsTscAx.dll

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

IRemoteDesktopClientSettings