Метод 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)
Указывает зашифрованный пароль. Чтобы задать это свойство, необходимо выполнить следующие действия.
- Преобразуйте пароль с открытым текстом в двоичный с помощью метода ConvertStringToBinary в классе CryptographicBuffer .
- Задайте свойство WinRTPasswordEncoding , используя эквивалентное значение для параметра кодирования, переданного методу ConvertStringToBinary на шаге 1.
- Вызовите метод DataProtectionProvider(String), передав "LOCAL=user" для входной строки.
- Вызовите метод ProtectAsync , чтобы зашифровать двоичную строку, содержащую пароль.
- Преобразуйте объект CryptographicBuffer, возвращенный методом ProtectAsync , в значение в кодировке Base64 с помощью метода EncodeToBase64String .
- Задайте это свойство (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 |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по