Interface IMsTscAxEvents
Inclui métodos que recebem informações do servidor relacionadas a eventos de controle de cliente. Os eventos incluem conexão e desconexão, solicitações de modo de tela inteira, logon bem-sucedido e condições de erro.
Membros
A interface IMsTscAxEvents herda da interface IDispatch . IMsTscAxEvents também tem estes tipos de membros:
Métodos
A interface IMsTscAxEvents tem esses métodos.
| Método | Descrição |
|---|---|
| OnAuthenticationWarningDismissed | Chamado depois que um controle ActiveX exibe uma caixa de diálogo de autenticação (por exemplo, a caixa de diálogo de erro de certificado). |
| OnAuthenticationWarningDisplayed | Chamado antes que um controle ActiveX exiba uma caixa de diálogo de autenticação (por exemplo, a caixa de diálogo de erro de certificado). |
| OnAutoReconnected | Chamado quando o controle de cliente se reconectou automaticamente a uma sessão remota. |
| OnAutoReconnecting | Chamado quando um cliente está no processo de reconectar automaticamente uma sessão com um servidor host da sessão rd. |
| OnAutoReconnecting2 | Chamado quando um cliente está no processo de reconectar automaticamente uma sessão com um servidor host da sessão rd. |
| OnChannelReceivedData | Chamado quando o cliente recebe dados em um canal virtual com script. |
| OnConfirmClose | Chamado quando o cliente chama o método IMsRdpClient::RequestClose . |
| OnConnected | Chamado quando o controle de cliente está no processo de estabelecer uma conexão com um servidor host de sessão de área de trabalho remota. |
| OnConnecting | Chamado quando o controle de cliente começa a se conectar a um servidor em resposta a uma chamada para IMsTscAx::Connect. |
| OnConnectionBarPullDown | Chamado quando o usuário arrasta para baixo na barra de conexão. |
| OnDevicesButtonPressed | Chamado quando o botão dispositivos na barra de conexão foi pressionado. |
| OnDisconnected | Chamado quando o controle de cliente foi desconectado do servidor Host da Sessão de Área de Trabalho Remota. |
| OnEnterFullScreenMode | Chamado quando o cliente entra no modo de tela inteira. Por exemplo, esse evento é chamado quando o usuário pressiona a combinação de teclas de atalho do modo de tela inteira (CTRL+ALT+BREAK). |
| OnFatalError | Chamado quando o controle de cliente encontra um erro fatal. |
| OnFocusReleased | Chamado quando a combinação de teclas de foco de liberação é pressionada. Por exemplo, esse evento é chamado quando o usuário pressiona a combinação ctrl+alt+seta para a esquerda ou ctrl+alt+seta para a direita. |
| OnIdleTimeoutNotification | Chamado quando não houve nenhuma entrada de mouse ou teclado pelo usuário durante o período definido pelo método IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout . |
| OnLeaveFullScreenMode | Chamado quando o cliente sai do modo de tela inteira. Por exemplo, esse evento é chamado quando o usuário pressiona a combinação de teclas de atalho do modo de tela inteira (CTRL+ALT+BREAK). |
| OnLoginComplete | Chamado quando o controle de cliente fez logon com êxito em um servidor Host da Sessão de Área de Trabalho Remota, após a exibição da caixa de diálogo Logon do Windows. |
| OnLogonError | Chamado quando ocorre um erro de logon ou outro evento de logon. |
| OnMouseInputModeChanged | Chamado quando o modo de entrada do mouse foi alterado. |
| OnNetworkStatusChanged | Chamado quando o status de rede foi alterado. |
| OnReceivedTSPublicKey | Chamado durante a sequência de conexão quando o cliente recupera a chave pública do servidor. Esse evento só será chamado se a propriedade NotifyTSPublicKey for VARIANT_TRUE. |
| OnRemoteDesktopSizeChange | Chamado para indicar que o tamanho do controle de cliente na área de trabalho remota foi alterado em resposta a uma operação de controle do cliente. |
| OnRemoteProgramDisplayed | Chamado quando um programa RemoteApp é exibido. |
| OnRemoteProgramResult | Chamado quando um programa RemoteApp retorna um resultado para o controle de cliente. |
| OnRemoteWindowDisplayed | Chamado quando uma janela do RemoteApp é exibida. |
| OnRequestContainerMinimize | Chamado quando o usuário pressiona o botão Minimizar na barra de conexão no modo de tela inteira. O disparo desse evento é uma solicitação que o aplicativo de contêiner minimiza a si mesmo. |
| OnRequestGoFullScreen | Chamado quando o cliente solicita a mudança para o modo de tela inteira e o método IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen é chamado para definir a propriedade ContainerHandledFullScreen como um valor diferente de zero. |
| OnRequestLeaveFullScreen | Chamado quando o cliente solicita para sair do modo de tela inteira e a propriedade IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen foi definida como um valor diferente de zero. |
| OnServiceMessageReceived | Chamado quando o cliente recebe uma mensagem do sistema. |
| OnUserNameAcquired | Chamado quando o nome de usuário foi adquirido pelo controle . |
| OnWarning | Chamado quando o controle de cliente encontra uma condição de erro que não é fatal. |
Comentários
Para obter mais informações sobre a Conexão da Web da Área de Trabalho Remota, consulte Requisitos para conexão da Web da Área de Trabalho Remota.
Os objetos de controle de cliente RDP (MsRdpClient, MsRdpClientNonScriptable e seus derivados) são objetos conectáveis. Para receber eventos do controle ActiveX da Área de Trabalho Remota sobre a sessão remota, um aplicativo pode implementar IMstscAxEvents e executar as etapas a seguir.
- Chame IUnknown::QueryInterface no objeto de controle de cliente RDP para obter um ponteiro para a interface IConnectionPointContainer .
- Chame IConnectionPointContainer::FindConnectionPoint, especificando
__uuidof(IMsTscAxEvents)como o parâmetro riid , para obter um ponteiro para a interface IConnectionPoint dos eventos de controle do cliente. - Chame IConnectionPoint::Advise para especificar a própria implementação do aplicativo de chamada de IMsTscAxEvents em que os eventos devem ser expedidos.
O aplicativo pode usar os DISPIDs a seguir ao implementar IDispatch::Invoke.
| dispIdMember | Expedir para o método |
|---|---|
| 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 | Nenhum. Fornece um código VT_UI4 status para o aplicativo. O aplicativo pode passar o código de status contido em 'pDispParams-rgvarg>[0].ulVal'' para IMsRdpClient7::GetStatusText para obter o texto de status associado. |
| 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 | Nenhum. Fornece um código de evento VT_UI4. Esse evento é emitido em cenários Microsoft Defender Application Guard. Ele não deve ser emitido durante operações normais. |
| DISPID_ONWOKEUPANDRECONNECTING = 37 | Nenhum. Esse evento não é mais emitido pelo controle ActiveX da Área de Trabalho Remota. |
| DISPID_ONLOCATIONREDIRECTIONENABLEDRECEIVED = 39 | Nenhum. Esse evento notifica o aplicativo de que ele pode começar a usar IMsRdpClientNonScriptable6::SendLocation2D ou IMsRdpClientNonScriptable6::SendLocation3D sua localização para o servidor para que a localização geográfica do cliente possa ser refletida na sessão remota. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient é definido como 791fa017-2de3-492e-acc5-53c67a2b94d0 CLSID_MsRdpClient10 é definido como C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting é definido como A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient2 é definido como 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A CLSID_MsRdpClient2a é definido como 971127BB-259F-48C2-BD75-5F97A3331551 CLSID_MsRdpClient2NotSafeForScripting é definido como 3523C2FB-4031-44E4-9A3B-F1E94986EE7F CLSID_MsRdpClient3 é definido como 7584C670-2274-4EFB-B00B-D6AABA6D3850 CLSID_MsRdpClient3a é definido como 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 CLSID_MsRdpClient3NotSafeForScripting é definido como ACE575FD-1FCF-4074-9401-EBAB990FA9DE CLSID_MsRdpClient4 é definido como 4EDCB26C-D24C-4E72-AF07-B576699AC0DE CLSID_MsRdpClient4a é definido como 54CE37E0-9834-41AE-9896-4DAB69DC022B CLSID_MsRdpClient4NotSafeForScripting é definido como 6AE29350-321B-42BE-BBE5-12FB5270C0DE CLSID_MsRdpClient5 é definido como 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 CLSID_MsRdpClient5NotSafeForScripting é definido como 4EB2F086-C818-447E-B32C-C51CE2B30D31 CLSID_MsRdpClient6 é definido como 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 CLSID_MsRdpClient6NotSafeForScripting é definido como D2EA46A7-C2BF-426B-AF24-E19C44456399 CLSID_MsRdpClient7 é definido como A9D7038D-B5ED-472E-9C47-94BEA90A5910 CLSID_MsRdpClient7NotSafeForScripting é definido como 54D38BF7-B1EF-4479-9674-1BD6EA465258 CLSID_MsRdpClient8 é definido como 5F681803-2900-4C43-A1CC-CF405404A676 CLSID_MsRdpClient8NotSafeForScripting é definido como A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9 é definido como 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting é definido como 8B918B82-7985-4C24-89DF-C33AD2BBFBCD CLSID_MsRdpClientNotSafeForScripting é definido como 7CACBD7B-0D99-468F-AC33-22E495C0AFE5 CLSID_MsTscAx é definido como 1FB464C8-09BB-4017-A2F5-EB742F04392F CLSID_MsTscAxNotSafeForScripting é definido como A41A4187-5A86-4E26-B40A-856F9035D9CB |
| IID |
IID_IMsTscAxEvents é definido como 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |