Share via

Класс MsRdpClient2a

  • Статья

Клиентский элемент управления Microsoft RDP (распространяемый) — версия 3a

Этот класс реализует следующие интерфейсы.

MsRdpClient2a имеет следующие типы элементов:

Методы

Класс MsRdpClient2a содержит эти методы.

Метод Описание
Подключение Инициирует подключение с помощью свойств, заданных в данный момент в элементе управления .
CreateVirtualChannels Создает объект виртуального канала на стороне клиента для каждого указанного имени виртуального канала.
Отключение Отключает активное подключение.
GetVirtualChannelOptions Извлекает набор параметров для виртуального канала.
NotifyRedirectDeviceChange Уведомляет модуль перенаправления устройств элемента ActiveX удаленного рабочего стола о том, что в системе произошло изменение устройства. Этот метод передает WM_DEVICECHANGE уведомления элементу управления.
OnAuthenticationWarningDismissed Вызывается после того, как элемент ActiveX отображает диалоговое окно проверки подлинности (например, диалоговое окно ошибки сертификата).
OnAuthenticationWarningDisplayed Вызывается перед отображением диалогового окна проверки подлинности элемента ActiveX (например, диалогового окна ошибки сертификата).
OnAutoReconnected Вызывается при автоматическом повторном подключении клиентского элемента управления к удаленному сеансу.
OnAutoReconnecting Вызывается, когда клиент находится в процессе автоматического повторного подключения сеанса к серверу узла сеансов удаленных рабочих стола.
OnAutoReconnecting2 Вызывается, когда клиент находится в процессе автоматического повторного подключения сеанса к серверу узла сеансов удаленных рабочих стола.
OnChannelReceivedData Вызывается, когда клиент получает данные в виртуальном канале с поддержкой сценариев.
OnConfirmClose Вызывается, когда клиент вызывает метод IMsRdpClient::RequestClose .
OnConnected Вызывается, когда клиентский элемент управления находится в процессе установления соединения с сервером узла сеансов удаленных рабочих стола.
OnConnecting Вызывается, когда клиентский элемент управления начинает подключение к серверу в ответ на вызов IMsTscAx::Connect.
OnConnectionBarPullDown Вызывается при перетаскивании пользователя на панели подключения.
OnDevicesButtonPressed Вызывается при нажатии кнопки устройств на панели подключения.
OnDisconnected Вызывается при отключении клиентского элемента управления от сервера узла сеансов удаленных рабочих стола.
OnEnterFullScreenMode Вызывается, когда клиент переходит в полноэкранный режим. Например, это событие вызывается, когда пользователь нажимает сочетание клавиш в полноэкранном режиме (CTRL+ALT+BREAK).
OnFatalError Вызывается, когда клиентский элемент управления обнаруживает неустранимую ошибку.
OnFocusReleased Вызывается при нажатии сочетания клавиш с фокусом освобождения. Например, это событие вызывается, когда пользователь нажимает сочетание клавиш CTRL+ALT+СТРЕЛКА ВЛЕВО или CTRL+ALT+СТРЕЛКА ВПРАВО.
OnIdleTimeoutNotification Вызывается, если пользователь не вводил данные с помощью мыши или клавиатуры в течение периода времени, заданного методом IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout .
OnLeaveFullScreenMode Вызывается, когда клиент выходит из полноэкранного режима. Например, это событие вызывается, когда пользователь нажимает сочетание клавиш в полноэкранном режиме (CTRL+ALT+BREAK).
OnLoginComplete Вызывается при успешном входе клиентского элемента управления на сервер узла сеансов удаленных рабочих стола после отображения диалогового окна Вход в Windows.
OnLogonError Вызывается при возникновении ошибки входа или другого события входа.
OnMouseInputModeChanged Вызывается при изменении режима ввода с помощью мыши.
OnNetworkStatusChanged Вызывается при изменении состояния сети.
OnReceivedTSPublicKey Вызывается во время последовательности подключения, когда клиент получает открытый ключ с сервера. Это событие вызывается, только если свойство NotifyTSPublicKeyVARIANT_TRUE.
OnRemoteDesktopSizeChange Вызывается, чтобы указать, что размер клиентского элемента управления на удаленном рабочем столе изменился в ответ на операцию клиентского управления.
OnRemoteProgramDisplayed Вызывается при отображении программы RemoteApp.
OnRemoteProgramResult Вызывается, когда программа RemoteApp возвращает результат клиентскому элементу управления.
OnRemoteWindowDisplayed Вызывается при отображении окна RemoteApp.
OnRequestContainerMinimize Вызывается, когда пользователь нажимает кнопку Свернуть на панели подключения в полноэкранном режиме. Запуск этого события — это запрос, который приложение-контейнер сводит к минимуму.
OnRequestGoFullScreen Вызывается, когда клиент запрашивает переключение в полноэкранный режим и вызывается метод IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen , чтобы задать свойству ContainerHandledFullScreen ненулевое значение.
OnRequestLeaveFullScreen Вызывается, когда клиент запрашивает выход из полноэкранного режима, а свойству IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen присвоено ненулевое значение.
OnServiceMessageReceived Вызывается, когда клиент получает системное сообщение.
OnUserNameAcquired Вызывается, когда имя пользователя было приобретено элементом управления .
OnWarning Вызывается, когда клиентский элемент управления обнаруживает ошибку, которая не является неустранимой.
RequestClose Запрашивает корректное завершение работы клиентского элемента управления.
ResetPassword Сбрасывает все состояния паролей в элементе управления .
SendKeys Отправляет ряд нажатий клавиш элементу управления. Нажатия клавиш находятся в форме кода сканирования, которая представляет собой данные клавиатуры из фактических физических клавиш.
SendOnVirtualChannel Отправляет данные на сервер узла сеансов удаленных рабочих стола по виртуальному каналу, который был создан ранее с помощью метода IMsTscAx::CreateVirtualChannels .
SetVirtualChannelOptions Задает параметры виртуального канала для клиентского элемента управления.

Свойства

Класс MsRdpClient2a имеет следующие свойства.

Свойство Тип доступа Описание
AdvancedSettings
 Только для чтения
 Указатель интерфейса IMsTscAdvancedSettings .
AdvancedSettings2
 Только для чтения
 Указатель на интерфейс IMsRdpClientAdvancedSettings , используемый для задания дополнительных параметров для клиентского элемента управления.
AdvancedSettings3
 Только для чтения
 Указатель на интерфейс IMsRdpClientAdvancedSettings2 , используемый для задания дополнительных параметров для клиентского элемента управления.
BinaryPassword
 Чтение/запись
 Данное свойство не поддерживается.
BinarySalt
 Чтение/запись
 Данное свойство не поддерживается.
CipherStrength
 Только для чтения
 Максимальная надежность шифрования текущего элемента управления.
ClearTextPassword
 Только на запись
 Пароль элемента ActiveX удаленного рабочего стола в формате открытого текста.
ColorDepth
 Чтение/запись
 Глубина цвета текущего элемента управления.
Подключен
 Только для чтения
 Состояние подключения текущего элемента управления.
ConnectedStatusText
 Чтение/запись
 Текст, отображаемый в клиентской области элемента управления, когда элемент управления находится в подключенном состоянии.
ConnectingText
 Чтение/запись
 Текст, отображаемый по центру элемента управления при соединении элемента управления.
DesktopHeight
 Чтение/запись
 Высота текущего элемента управления (в пикселях) на начальном удаленном рабочем столе.
DesktopWidth
 Чтение/запись
 Ширина текущего элемента управления (в пикселях) на начальном удаленном рабочем столе.
DisconnectedText
 Чтение/запись
 Текст, отображаемый по центру элемента управления перед завершением соединения.
Домен
 Чтение/запись
 Домен, в который входит текущий пользователь.
ExtendedDisconnectReason
 Только для чтения
 Расширенная информация о причине отключения клиентского элемента управления.
FullScreen
 Чтение/запись
 Указывает, находится ли элемент управления в полноэкранном режиме.
FullScreenTitle
 Только на запись
 Название окна, отображаемое, когда элемент управления находится в полноэкранном режиме.
HorizontalScrollBarVisible
 Только для чтения
 Указывает, отображается ли в элементе управления горизонтальная полоса прокрутки.
PortablePassword
 Чтение/запись
 Данное свойство не поддерживается.
PortableSalt
 Чтение/запись
 Данное свойство не поддерживается.
SecuredSettings
 Только для чтения
 Указатель интерфейса IMsTscSecuredSettings .
SecuredSettings2
 Только для чтения
 Указатель на интерфейс IMsRdpClientSecuredSettings , используемый для задания защищенных параметров для клиентского элемента управления.
SecuredSettingsEnabled
 Только для чтения
 Указывает, доступен ли интерфейс IMsTscSecuredSettings .
Сервера
 Чтение/запись
 Имя сервера, к которому подключен текущий элемент управления.
StartConnected
 Чтение/запись
 Указывает, установит ли элемент управления подключение к серверу узла сеансов удаленных рабочих стола сразу после запуска.
Пользователя
 Чтение/запись
 Учетные данные для входа в систему с именем пользователя.
Версия
 Только для чтения
 Номер версии текущего элемента управления.
VerticalScrollBarVisible
 Только для чтения
 Указывает, отображает ли элемент управления вертикальную полосу прокрутки.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Библиотека типов
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
 CLSID_MsRdpClient2a определяется как 971127BB-259F-48C2-BD75-5F97A3331551

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

Классы элементов ActiveX для удаленного рабочего стола