Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Клиентский элемент управления Microsoft RDP (распространяемый) — версия 2
Этот класс реализует следующие интерфейсы.
MsRdpClient имеет следующие типы элементов:
Методы
Класс MsRdpClient содержит эти методы.
| Метод | Описание |
|---|---|
| Подключение | Инициирует подключение с помощью свойств, заданных в данный момент в элементе управления . |
| 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 | Задает параметры виртуального канала для клиентского элемента управления. |
Свойства
Класс MsRdpClient имеет следующие свойства.
| Свойство | Тип доступа | Описание |
|---|---|---|
|
AdvancedSettings |
Только для чтения |
Указатель интерфейса IMsTscAdvancedSettings . |
|
AdvancedSettings2 |
Только для чтения |
Указатель на интерфейс IMsRdpClientAdvancedSettings , используемый для задания дополнительных параметров для клиентского элемента управления. |
|
BinaryPassword |
Чтение/запись |
Данное свойство не поддерживается. |
|
BinarySalt |
Чтение/запись |
Данное свойство не поддерживается. |
|
CipherStrength |
Только для чтения |
Максимальная надежность шифрования текущего элемента управления. |
|
ClearTextPassword |
Только на запись |
Пароль элемента управления ActiveX удаленного рабочего стола в формате открытого текста. |
|
ColorDepth |
Чтение/запись |
Глубина цвета текущего элемента управления. |
|
Подключен |
Только для чтения |
Состояние подключения текущего элемента управления. |
|
ConnectingText |
Чтение/запись |
Текст, отображаемый по центру элемента управления при соединении элемента управления. |
|
DesktopHeight |
Чтение/запись |
Высота текущего элемента управления (в пикселях) на начальном удаленном рабочем столе. |
|
DesktopWidth |
Чтение/запись |
Ширина текущего элемента управления (в пикселях) на начальном удаленном рабочем столе. |
|
DisconnectedText |
Чтение/запись |
Текст, который отображается по центру в элементе управления перед завершением соединения. |
|
Домен |
Чтение/запись |
Домен, в который входит текущий пользователь. |
|
ExtendedDisconnectReason |
Только для чтения |
Дополнительные сведения о причине отключения клиентского элемента управления. |
|
FullScreen |
Чтение/запись |
Указывает, находится ли элемент управления в полноэкранном режиме. |
|
FullScreenTitle |
Только на запись |
Заголовок окна, отображаемый, когда элемент управления находится в полноэкранном режиме. |
|
HorizontalScrollBarVisible |
Только для чтения |
Указывает, отображается ли в элементе управления горизонтальная полоса прокрутки. |
|
PortablePassword |
Чтение/запись |
Данное свойство не поддерживается. |
|
PortableSalt |
Чтение/запись |
Данное свойство не поддерживается. |
|
SecuredSettings |
Только для чтения |
Указатель интерфейса IMsTscSecuredSettings . |
|
SecuredSettings2 |
Только для чтения |
Указатель на интерфейс IMsRdpClientSecuredSettings , используемый для задания защищенных параметров для клиентского элемента управления. |
|
SecuredSettingsEnabled |
Только для чтения |
Указывает, доступен ли интерфейс IMsTscSecuredSettings . |
|
Сервера |
Чтение/запись |
Имя сервера, к которому подключен текущий элемент управления. |
|
StartConnected |
Чтение/запись |
Указывает, установит ли элемент управления подключение к серверу узла сеансов удаленных рабочих стола сразу после запуска. |
|
Пользователя |
Чтение/запись |
Учетные данные для входа в систему с именем пользователя. |
|
Версия |
Только для чтения |
Номер версии текущего элемента управления. |
|
VerticalScrollBarVisible |
Только для чтения |
Указывает, отображает ли элемент управления вертикальную полосу прокрутки. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Библиотека типов |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient определяется как 791fa017-2de3-492e-acc5-53c67a2b94d0 |