Интерфейс IMsRdpClient8
Предоставляет методы и свойства, необходимые для настройки и использования клиентского элемента управления. Является производным от интерфейса IMsRdpClient7 .
Элементы
Интерфейс IMsRdpClient8 наследуется от IMsRdpClient7. IMsRdpClient8 также имеет следующие типы членов:
Методы
Интерфейс IMsRdpClient8 содержит следующие методы.
| Метод | Описание |
|---|---|
| Подключение | Инициирует подключение, используя свойства, которые в данный момент заданы в элементе управления . |
| CreateVirtualChannels | Создает объект виртуального канала на стороне клиента для каждого указанного имени виртуального канала. |
| Отключение | Отключает активное подключение. |
| GetErrorDescription | Возвращает описание ошибки для событий отключения сеанса. |
| GetStatusText | Извлекает текст состояния для указанного кода состояния. |
| GetVirtualChannelOptions | Извлекает набор параметров для виртуального канала. |
| Повтор соединения | Повторно подключается к удаленному сеансу с новой шириной и высотой рабочего стола. |
| RequestClose | Запрашивает корректное завершение работы элемента ActiveX удаленного рабочего стола. |
| SendOnVirtualChannel | Отправляет данные на сервер узла сеансов удаленных рабочих стола по виртуальному каналу, созданному ранее с помощью метода CreateVirtualChannels . |
| SendRemoteAction | Вызывает выполнение действия в удаленном сеансе. |
| SetVirtualChannelOptions | Задает параметры виртуального канала для элемента ActiveX удаленного рабочего стола. |
Свойства
Интерфейс IMsRdpClient8 имеет следующие свойства.
| Свойство | Тип доступа | Описание |
|---|---|---|
|
AdvancedSettings |
Только для чтения |
Извлекает указатель интерфейса IMsTscAdvancedSettings . |
|
AdvancedSettings2 |
Только для чтения |
Извлекает указатель на интерфейс IMsRdpClientAdvancedSettings . Интерфейс можно использовать для установки дополнительных параметров для клиентского элемента управления. |
|
AdvancedSettings3 |
Только для чтения |
Извлекает указатель на интерфейс IMsRdpClientAdvancedSettings2 . Интерфейс можно использовать для установки дополнительных параметров для клиентского элемента управления. |
|
AdvancedSettings4 |
Только для чтения |
Извлекает указатель на интерфейс IMsRdpClientAdvancedSettings3 . |
|
AdvancedSettings5 |
Только для чтения |
Извлекает указатель на интерфейс IMsRdpClientAdvancedSettings4 . |
|
AdvancedSettings6 |
Только для чтения |
Извлекает интерфейс IMsRdpClientAdvancedSettings5 . |
|
AdvancedSettings7 |
Только для чтения |
Извлекает интерфейс IMsRdpClientAdvancedSettings6 . |
|
AdvancedSettings8 |
Только для чтения |
Извлекает объект, поддерживающий интерфейс IMsRdpClientAdvancedSettings7 . |
|
AdvancedSettings9 |
Только для чтения |
Содержит объект, поддерживающий интерфейс IMsRdpClientAdvancedSettings8 . |
|
CipherStrength |
Только для чтения |
Извлекает максимальную надежность шифрования текущего элемента управления. |
|
ColorDepth |
Чтение/запись |
Глубина цвета (в битах на пиксель) для соединения элемента управления. |
|
Подключен |
Только для чтения |
Извлекает состояние подключения текущего элемента управления. |
|
ConnectedStatusText |
Чтение/запись |
Содержит текст, отображаемый в клиентской области элемента управления, пока элемент управления находится в подключенном состоянии. |
|
ConnectingText |
Чтение/запись |
Указывает текст, отображаемый по центру элемента управления при соединении элемента управления. |
|
DesktopHeight |
Чтение/запись |
Указывает высоту текущего элемента управления (в пикселях) на начальном удаленном рабочем столе. |
|
DesktopWidth |
Чтение/запись |
Задает ширину текущего элемента управления (в пикселях) на начальном удаленном рабочем столе. |
|
DisconnectedText |
Чтение/запись |
Указывает текст, который отображается по центру элемента управления перед завершением соединения. |
|
Домен |
Чтение/запись |
Указывает домен, в который входит текущий пользователь. |
|
ExtendedDisconnectReason |
Только для чтения |
Содержит расширенные сведения о причине отключения элемента управления. |
|
FullScreen |
Чтение/запись |
Определяет, находится ли клиентский элемент управления в полноэкранном режиме. |
|
FullScreenTitle |
Только на запись |
Указывает заголовок окна, отображаемый, когда элемент управления находится в полноэкранном режиме. |
|
HorizontalScrollBarVisible |
Только для чтения |
Указывает, отображается ли в элементе управления горизонтальная полоса прокрутки. |
|
MsRdpClientShell |
Только для чтения |
Извлекает интерфейс параметров клиента с поддержкой сценариев IMsRdpClientShell. |
|
RemoteProgram |
Только для чтения |
Извлекает объект, поддерживающий интерфейс ITSRemoteProgram . |
|
RemoteProgram2 |
Только для чтения |
Извлекает объект, поддерживающий интерфейс ITSRemoteProgram2 . |
|
SecuredSettings |
Только для чтения |
Извлекает указатель интерфейса IMsTscSecuredSettings . |
|
SecuredSettings2 |
Только для чтения |
Извлекает указатель на интерфейс IMsRdpClientSecuredSettings . Этот интерфейс можно использовать для задания защищенных параметров для клиентского элемента управления. |
|
SecuredSettings3 |
Только для чтения |
Извлекает объект, поддерживающий интерфейс IMsRdpClientSecuredSettings2 . |
|
SecuredSettingsEnabled |
Только для чтения |
Указывает, доступен ли интерфейс IMsTscSecuredSettings . Это значит, находится ли веб-страница, содержащая элемент управления, в настоящее время в одной из разрешенных зон безопасности URL-адресов в Интернете Обозреватель. |
|
Сервера |
Чтение/запись |
Указывает имя сервера, к которому подключен текущий элемент управления. |
|
StartConnected |
Чтение/запись |
Указывает, установит ли элемент управления подключение к серверу узла сеансов удаленных рабочих стола сразу после запуска. |
|
TransportSettings |
Только для чтения |
Извлекает данные, переданные через скрипт в интерфейс IMsRdpClientTransportSettings . |
|
TransportSettings2 |
Только для чтения |
Извлекает интерфейс IMsRdpClientTransportSettings2 . |
|
TransportSettings3 |
Только для чтения |
Извлекает объект, поддерживающий интерфейс IMsRdpClientTransportSettings3 . |
|
Пользователя |
Чтение/запись |
Указывает учетные данные для входа в систему с именем пользователя. |
|
Версия |
Только для чтения |
Указывает номер версии текущего элемента управления. |
|
VerticalScrollBarVisible |
Только для чтения |
Указывает, отображает ли элемент управления вертикальную полосу прокрутки. |
Комментарии
Интерфейс IMsRdpClient8 был расширен следующими интерфейсами, при этом каждый новый интерфейс наследует все методы и свойства предыдущих интерфейсов:
Дополнительные сведения о веб-подключении к удаленному рабочему столу см. в разделе Требования к веб-подключению к удаленному рабочему столу.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 8 |
| Минимальная версия сервера |
Windows Server 2012 |
| Библиотека типов |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient10 определяется как C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting определяется как A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient8 определяется как 5F681803-2900-4C43-A1CC-CF405404A676 CLSID_MsRdpClient8NotSafeForScripting определяется как A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9 определяется как 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting определяется как 8B918B82-7985-4C24-89DF-C33AD2BBFBCD. |
| IID |
IID_IMsRdpClient8 определяется как 4247E044-9271-43A9-BC49-E2AD9E855D62 |