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


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

Комментарии

Этот интерфейс был расширен следующими интерфейсами, при этом каждый новый интерфейс наследует все методы и свойства предыдущих интерфейсов:

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

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

Требования

Требование Значение
Минимальная версия клиента
Windows Vista
Минимальная версия сервера
Windows Server 2008
Библиотека типов
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsRdpClientAdvancedSettings определяется как 3c65b4ab-12b3-465b-acd4-b8dad3bff9e2

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

Справочник по веб-подключению к удаленному рабочему столу

IMsTscAdvancedSettings