Интерфейс 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 |