Интерфейс IMsRdpClientAdvancedSettings
Управляет расширенными параметрами клиента. Является производным от интерфейса IMsTscAdvancedSettings . Этот интерфейс включает методы для получения и задания дополнительных (необязательных) свойств для элемента управления ActiveX удаленного рабочего стола.
Чтобы получить экземпляр этого интерфейса, используйте свойство IMsTscAx::AdvancedSettings для получения указателя интерфейса IMsTscAdvancedSettings . Затем вызовите QueryInterface для указателя IMsTscAdvancedSettings и передайте IID_IMsRdpClientAdvancedSettingsв QueryInterface.
Элементы
Интерфейс IMsRdpClientAdvancedSettings наследуется от IMsTscAdvancedSettings. IMsRdpClientAdvancedSettings также имеет следующие типы элементов:
Элемент Property
Интерфейс IMsRdpClientAdvancedSettings имеет следующие свойства.
| Свойство | Тип доступа | Описание |
|---|---|---|
| AcceleratorPassthrough |
Чтение/запись |
Указывает, следует ли передавать ускорители клавиатуры на сервер. |
| BitmapCacheSize |
Чтение/запись |
Размер (в килобайтах) файла кэша растровых изображений, используемого для растровых изображений размером 8 бит на пиксель. Допустимые числовые значения этого свойства — от 1 до 32 включительно. |
| BitmapPersistence |
Чтение/запись |
Указывает, следует ли использовать постоянное кэширование растровых изображений. Постоянное кэширование может повысить производительность, но требует дополнительного места на диске. |
| BitmapVirtualCache16BppSize |
Чтение/запись |
Указывает размер файла кэша постоянного растрового изображения в мегабайтах, который будет использоваться для параметров высокого цвета 15 и 16 бит на пиксель. |
| BitmapVirtualCache24BppSize |
Чтение/запись |
Задает размер файла кэша постоянного растрового изображения в мегабайтах, который будет использоваться для параметра высокого цвета 24 бита на пиксель. |
| BitmapVirtualCacheSize |
Чтение/запись |
Задает размер файла кэша постоянного растрового изображения в мегабайтах, который будет использоваться для цвета 8 бит на пиксель. Допустимые числовые значения этого свойства — от 1 до 32 включительно. Обратите внимание, что максимальный размер всех файлов виртуального кэша составляет 128 МБ. Связанные свойства включают свойства BitmapVirtualCache16BppSize и BitmapVirtualCache24BppSize . |
| brushSupportLevel |
Чтение/запись |
Данное свойство не поддерживается. |
| CachePersistenceActive |
Чтение/запись |
Указывает, следует ли использовать постоянное кэширование точечных изображений. |
| ClearTextPassword |
Только на запись |
Указывает пароль, с помощью которого необходимо подключиться. Дополнительные сведения см. в разделе Интерфейс IMsTscNonScriptable . |
| ConnectToServerConsole |
Чтение/запись |
Данное свойство не поддерживается. |
| ConnectWithEndpoint |
Только на запись |
Данное свойство не поддерживается. |
| DedicatedTerminal |
Чтение/запись |
Данное свойство не поддерживается. |
| DisableCtrlAltDel |
Чтение/запись |
Указывает, должен ли отображаться начальный экран пояснений в Winlogon. |
| DisplayConnectionBar |
Чтение/запись |
Указывает, следует ли использовать панель подключения. Значение по умолчанию — VARIANT_TRUE, которое включает свойство . |
| DoubleClickDetect |
Чтение/запись |
Указывает, определяет ли клиент двойной щелчок для сервера. |
| EnableMouse |
Чтение/запись |
Данное свойство не поддерживается. |
| EnableWindowsKey |
Чтение/запись |
Указывает, можно ли использовать ключ Windows в удаленном сеансе. |
| EncryptionEnabled |
Чтение/запись |
Данное свойство не поддерживается. Невозможно отключить шифрование. |
| GrabFocusOnConnect |
Чтение/запись |
Указывает, должен ли клиентский элемент управления находиться в фокусе при подключении. |
| HotKeyAltEsc |
Чтение/запись |
Указывает код виртуального ключа, добавляемый в ALT для определения замены клавиш ALT+ESC. VK_INSERT является значением по умолчанию с alt+INSERT в качестве результирующей последовательности. Это свойство допустимо, только если свойство KeyboardHookMode не включено. |
| HotKeyAltShiftTab |
Чтение/запись |
Указывает код виртуального ключа, добавляемый в ALT, чтобы определить замену клавиш alt+SHIFT+TAB. VK_NEXT является значением по умолчанию, а результирующая последовательность — ALT+PAGE DOWN. Это свойство допустимо, только если свойство KeyboardHookMode не включено. |
| HotKeyAltSpace |
Чтение/запись |
Указывает код виртуального ключа, добавляемый в ALT для определения замены клавиш ALT+ПРОБЕЛ. VK_DELETE используется по умолчанию, а результирующая последовательность — ALT+DELETE. Это свойство допустимо, только если свойство KeyboardHookMode не включено. |
| HotKeyAltTab |
Чтение/запись |
Указывает код виртуального ключа, добавляемый в ALT, чтобы определить замену сочетаний клавиш ALT+TAB. VK_PRIOR является значением по умолчанию, а результирующая последовательность — ALT+PAGE UP. Это свойство допустимо, только если свойство KeyboardHookMode не включено. |
| HotKeyCtrlAltDel |
Чтение/запись |
Указывает код виртуальной клавиши, добавляемый в сочетание клавиш CTRL+ALT для определения замены клавиш CTRL+ALT+DELETE, также называемой последовательностью безопасного внимания (SAS). VK_END используется по умолчанию. Обратите внимание, что даже если свойство KeyboardHookMode включено, ctrl+ALT+DELETE никогда не перенаправляется на удаленный сервер. CTRL+ALT+DELETE — это локальная последовательность SAS. |
| HotKeyCtrlEsc |
Чтение/запись |
Указывает код виртуальной клавиши, добавляемый в ALT, чтобы определить замену клавиш ctrl+ESC. VK_HOME является значением по умолчанию с ALT+HOME в качестве результирующей последовательности. Это свойство допустимо, только если свойство KeyboardHookMode не включено. |
| HotKeyFullScreen |
Чтение/запись |
Указывает код виртуальной клавиши, добавляемый в сочетание клавиш CTRL+ALT, чтобы определить замену горячей клавиши для перехода в полноэкранный режим. VK_CANCEL является значением по умолчанию. |
| InputEventsAtOnce |
Чтение/запись |
Данное свойство не поддерживается. |
| keepAliveInterval |
Чтение/запись |
Задает интервал в миллисекундах, с которым клиент отправляет на сервер сообщения о работоспособности. Значение свойства по умолчанию равно нулю, что отключает поддержание активности сообщений. Минимально допустимое значение этого свойства — 10 000, что представляет собой 10 секунд. Обратите внимание, что параметр групповой политики, указывающий, разрешены ли постоянные клиентские подключения к серверу, может переопределить этот параметр свойства. |
| KeyboardFunctionKey |
Чтение/запись |
Допустимо только для Windows CE. |
| KeyboardSubType |
Чтение/запись |
Допустимо только для Windows CE. |
| KeyboardType |
Чтение/запись |
Допустимо только для Windows CE. |
| LoadBalanceInfo |
Чтение/запись |
Указывает файл cookie балансировки нагрузки, который будет помещен в пакет запроса на подключение X.224 в последовательности подключений сервера узла сеансов удаленных рабочих стола. |
| maxEventCount |
Чтение/запись |
Данное свойство не поддерживается. |
| MaximizeShell |
Чтение/запись |
Указывает, следует ли развернуть программы, запускаемые со свойством StartProgram . |
| minInputSendInterval |
Чтение/запись |
Задает минимальный интервал (в миллисекундах) между отправкой событий мыши. |
| MinutesToIdleTimeout |
Чтение/запись |
Указывает максимальный период времени (в минутах), в течение котором клиент должен оставаться подключенным без ввода данных пользователем. Если истекает указанное время, элемент управления вызывает метод IMsTscAxEvents::OnIdleTimeoutNotification . |
| NotifyTSPublicKey |
Чтение/запись |
Данное свойство не поддерживается. |
| NumBitmapCaches |
Чтение/запись |
Данное свойство не поддерживается. |
| orderDrawThreshold |
Чтение/запись |
Данное свойство не поддерживается. |
| overallConnectionTimeout |
Чтение/запись |
Указывает общий период времени (в секундах) ожидания клиентского элемента управления до завершения подключения. Максимально допустимое значение этого свойства — 600, что составляет 10 минут. Если указанное время истекает до завершения подключения, элемент управления отключается и вызывает метод IMsTscAxEvents::OnDisconnected . Связанное свойство — singleConnectionTimeout. |
| PerformanceFlags |
Чтение/запись |
Указывает набор функций, которые можно задать на сервере для повышения производительности. |
| PersistCacheDirectory |
Только на запись |
Данное свойство не поддерживается. |
| PinConnectionBar |
Чтение/запись |
Указывает состояние панели подключения пользовательского интерфейса. Присвоив этому свойству значение VARIANT_TRUE устанавливает состояние "пониженное", то есть невидимое для пользователя и недоступное для ввода. VARIANT_FALSE задает состояние "поднято" и доступно для ввода пользователем. |
| RdpdrClipCleanTempDirString |
Чтение/запись |
Данное свойство не поддерживается. |
| RdpdrClipPasteInfoString |
Чтение/запись |
Данное свойство не поддерживается. |
| RdpdrLocalPrintingDocName |
Чтение/запись |
Данное свойство не поддерживается. |
| RDPPort |
Чтение/запись |
Указывает порт подключения. Значение по умолчанию — 3389. |
| RedirectDrives |
Чтение/запись |
Указывает, разрешено ли перенаправление дисков. |
| RedirectPorts |
Чтение/запись |
Указывает, разрешено ли перенаправление локальных портов (например, COM и LPT). |
| RedirectPrinters |
Чтение/запись |
Указывает, разрешено ли перенаправление принтеров. |
| RedirectSmartCards |
Чтение/запись |
Указывает, разрешено ли перенаправление смарт-карт. |
| SasSequence |
Чтение/запись |
Указывает последовательность безопасного доступа, используемую клиентом для доступа к экрану входа на сервере. |
| ScaleBitmapCachesByBPP |
Чтение/запись |
Данное свойство не поддерживается. |
| ShadowBitmap |
Чтение/запись |
Данное свойство не поддерживается. Windows Vista: Указывает, следует ли использовать теневые растровые изображения. |
| shutdownTimeout |
Чтение/запись |
Указывает время ожидания ответа сервера на запрос об отключении (в секундах). Значение свойства по умолчанию — 10. Максимально допустимое значение свойства — 600, что составляет 10 минут. Если сервер не отвечает в течение указанного времени, клиентский элемент управления отключается. |
| singleConnectionTimeout |
Чтение/запись |
Указывает максимальное время (в секундах) ожидания клиентского элемента управления подключения к IP-адресу. Во время подключения элемент управления может попытаться подключиться к нескольким IP-адресам. Максимально допустимое значение этого свойства — 600. Связанное свойство — overallConnectionTimeout. |
| Интеллектуальное масштабирование |
Чтение/запись |
Указывает, следует ли масштабировать дисплей в соответствии с клиентской областью элемента управления. VARIANT_TRUE включает масштабирование. Обратите внимание, что полосы прокрутки не отображаются при включении свойства SmartSizing . |
| SmoothScroll |
Чтение/запись |
Данное свойство не поддерживается. |
| TransportType |
Чтение/запись |
Указывает тип транспорта, используемый клиентом. Это свойство не используется элементом ActiveX удаленного рабочего стола. |
| WinCEFixedPalette |
Чтение/запись |
Допустимо только для Windows CE. |
Комментарии
Этот интерфейс был расширен следующими интерфейсами, при этом каждый новый интерфейс наследует все методы и свойства предыдущих интерфейсов:
- IMsRdpClientAdvancedSettings2
- IMsRdpClientAdvancedSettings3
- IMsRdpClientAdvancedSettings4
- IMsRdpClientAdvancedSettings5
- IMsRdpClientAdvancedSettings6
- IMsRdpClientAdvancedSettings7
- IMsRdpClientAdvancedSettings8
Это свойство нельзя задать при подключении элемента управления, если не указано иное.
Дополнительные сведения о веб-подключении к удаленному рабочему столу см. в разделе Требования к веб-подключению к удаленному рабочему столу.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Библиотека типов |
|
| DLL |
|
| IID |
IID_IMsRdpClientAdvancedSettings определяется как 3c65b4ab-12b3-465b-acd4-b8dad3bff9e2 |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по