Интерфейс IMsTscAxEvents
Включает методы, получающие с сервера сведения, связанные с событиями клиентского управления. События включают подключение и отключение, запросы в полноэкранном режиме, успешный вход в систему и условия ошибок.
Элементы
Интерфейс IMsTscAxEvents наследуется от интерфейса IDispatch . IMsTscAxEvents также имеет следующие типы элементов:
Методы
Интерфейс IMsTscAxEvents содержит следующие методы.
| Метод | Описание |
|---|---|
| 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 | Вызывается, когда клиентский элемент управления сталкивается с ошибкой, которая не является неустранимой. |
Комментарии
Дополнительные сведения о веб-подключении к удаленному рабочему столу см. в разделе Требования к веб-подключению к удаленному рабочему столу.
Клиентские управляющие объекты RDP (MsRdpClient, MsRdpClientNonScriptable и их производные) являются подключаемыми объектами. Чтобы получать события из элемента управления ActiveX удаленного рабочего стола об удаленном сеансе, приложение может реализовать IMstscAxEvents и выполнить следующие действия.
- Вызовите IUnknown::QueryInterface в объекте клиентского элемента управления RDP, чтобы получить указатель на интерфейс IConnectionPointContainer .
- Вызовите IConnectionPointContainer::FindConnectionPoint, указав
__uuidof(IMsTscAxEvents)в качестве параметра riid , чтобы получить указатель на интерфейс IConnectionPoint событий клиентского элемента управления. - Вызовите IConnectionPoint::Advise , чтобы указать собственную реализацию IMsTscAxEvents вызывающего приложения, в которую должны быть отправлены события.
Приложение может использовать следующие идентификаторы DISPID при реализации IDispatch::Invoke.
| dispIdMember | Отправка в метод |
|---|---|
| DISPID_CONNECTING = 1 | OnConnecting |
| DISPID_CONNECTED = 2 | OnConnected |
| DISPID_LOGINCOMPLETE = 3 | OnLoginComplete |
| DISPID_DISCONNECTED = 4 | OnDisconnected |
| DISPID_ENTERFULLSCREENMODE = 5 | OnEnterFullScreenMode |
| DISPID_LEAVEFULLSCREENMODE = 6 | OnLeaveFullScreenMode |
| DISPID_CHANNELRECEIVEDDATA = 7 | OnChannelReceivedData |
| DISPID_REQUESTGOFULLSCREEN = 8 | OnRequestGoFullScreen |
| DISPID_REQUESTLEAVEFULLSCREEN = 9 | OnRequestLeaveFullScreen |
| DISPID_FATALERROR = 10 | OnFatalError |
| DISPID_WARNING = 11 | OnWarning |
| DISPID_REMOTEDESKTOPSIZECHANGE = 12 | OnRemoteDesktopSizeChange |
| DISPID_IDLETIMEOUTNOTIFICATION = 13 | OnIdleTimeoutNotification |
| DISPID_REQUESTCONTAINERMINIMIZE = 14 | OnRequestContainerMinimize |
| DISPID_CONFIRMCLOSE = 15 | OnConfirmClose |
| DISPID_RECEIVEDTSPUBLICKEY = 16 | OnReceivedTSPublicKey |
| DISPID_AUTORECONNECTING = 17 | OnAutoReconnecting |
| DISPID_INTERNALDIALOGDISPLAYED = 18 | OnAuthenticationWarningDisplayed |
| DISPID_INTERNALDIALOGDISMISSED = 19 | OnAuthenticationWarningDismissed |
| DISPID_ONREMOTEPROGRAMRESULT = 20 | OnRemoteProgramResult |
| DISPID_ONREMOTEPROGRAMDISPLAYED = 21 | OnRemoteProgramDisplayed |
| DISPID_LOGONERROR = 22 | OnLogonError |
| DISPID_FOCUSRELEASED = 23 | OnFocusReleased |
| DISPID_USERNAMEACQUIRED = 24 | OnUserNameAcquired |
| DISPID_MOUSEINPUTMODECHANGED = 26 | OnMouseInputModeChanged |
| DISPID_ONSTATUSINFO = 27 | Нет. Предоставляет VT_UI4 код состояния для приложения. Приложение может передать код состояния, содержащийся в pDispParams-rgvarg>[0].ulVal', в IMsRdpClient7::GetStatusText , чтобы получить связанный текст состояния. |
| DISPID_SERVICEMESSAGERECEIVED = 28 | OnServiceMessageReceived |
| DISPID_ONREMOTEWINDOWDISPLAYED = 29 | OnRemoteWindowDisplayed |
| DISPID_CONNECTIONBARPULLDOWN = 30 | OnConnectionBarPullDown |
| DISPID_ONNETWORKSTATUSCHANGED = 32 | OnNetworkStatusChanged |
| DISPID_AUTORECONNECTED = 33 | OnAutoReconnected |
| DISPID_AUTORECONNECTING2 = 34 | OnAutoReconnecting2 |
| DISPID_CONNECTIONBARDEVICES = 35 | OnDevicesButtonPressed |
| DISPID_HVSINOTIFICATION = 36 | Нет. Предоставляет код события VT_UI4. Это событие создается в Microsoft Defender Application Guard сценариях. Он не должен выдаваться во время обычных операций. |
| DISPID_ONWOKEUPANDRECONNECTING = 37 | Нет. Это событие больше не создается элементом ActiveX удаленного рабочего стола. |
| DISPID_ONLOCATIONREDIRECTIONENABLEDRECEIVED = 39 | Нет. Это событие уведомляет приложение о том, что оно может начать использовать IMsRdpClientNonScriptable6::SendLocation2D или IMsRdpClientNonScriptable6::SendLocation3D , чтобы географическое расположение клиента можно было отразить в удаленном сеансе. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Библиотека типов |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient определяется как 791fa017-2de3-492e-acc5-53c67a2b94d0 CLSID_MsRdpClient10 определяется как C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting определяется как A0C63C30-F08D-4AB4-907C-34905D770C7D. CLSID_MsRdpClient2 определяется как 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A CLSID_MsRdpClient2a определяется как 971127BB-259F-48C2-BD75-5F97A3331551 CLSID_MsRdpClient2NotSafeForScripting определяется как 3523C2FB-4031-44E4-9A3B-F1E94986EE7F CLSID_MsRdpClient3 определяется как 7584C670-2274-4EFB-B00B-D6AABA6D3850 CLSID_MsRdpClient3a определяется как 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 CLSID_MsRdpClient3NotSafeForScripting определяется как ACE575FD-1FCF-4074-9401-EBAB990FA9DE CLSID_MsRdpClient4 определяется как 4EDCB26C-D24C-4E72-AF07-B576699AC0DE CLSID_MsRdpClient4a определяется как 54CE37E0-9834-41AE-9896-4DAB69DC022B CLSID_MsRdpClient4NotSafeForScripting определяется как 6AE29350-321B-42BE-BBE5-12FB5270C0DE CLSID_MsRdpClient5 определяется как 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 CLSID_MsRdpClient5NotSafeForScripting определяется как 4EB2F086-C818-447E-B32C-C51CE2B30D31 CLSID_MsRdpClient6 определяется как 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 CLSID_MsRdpClient6NotSafeForScripting определяется как D2EA46A7-C2BF-426B-AF24-E19C44456399 CLSID_MsRdpClient7 определяется как A9D7038D-B5ED-472E-9C47-94BEA90A5910 CLSID_MsRdpClient7NotSafeForScripting определяется как 54D38BF7-B1EF-4479-9674-1BD6EA465258 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 CLSID_MsRdpClientNotSafeForScripting определяется как 7CACBD7B-0D99-468F-AC33-22E495C0AFE5 CLSID_MsTscAx определяется как 1FB464C8-09BB-4017-A2F5-EB742F04392F CLSID_MsTscAxNotSafeForScripting определяется как A41A4187-5A86-4E26-B40A-856F9035D9CB |
| IID |
IID_IMsTscAxEvents определяется как 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |