Interfaz IMsTscAxEvents
Incluye métodos que reciben información del servidor relacionado con eventos de control de cliente. Los eventos incluyen la conexión y desconexión, las solicitudes en modo de pantalla completa, el inicio de sesión correcto y las condiciones de error.
Miembros
La interfaz IMsTscAxEvents hereda de la interfaz IDispatch . IMsTscAxEvents también tiene estos tipos de miembros:
Métodos
La interfaz IMsTscAxEvents tiene estos métodos.
| Método | Descripción |
|---|---|
| OnAuthenticationWarningDismissed | Se llama después de que un control ActiveX muestre un cuadro de diálogo de autenticación (por ejemplo, el cuadro de diálogo de error de certificado). |
| OnAuthenticationWarningDisplayed | Se llama antes de que un control ActiveX muestre un cuadro de diálogo de autenticación (por ejemplo, el cuadro de diálogo de error de certificado). |
| OnAutoReconnected | Se llama cuando el control de cliente se ha vuelto a conectar automáticamente a una sesión remota. |
| OnAutoReconnecting | Se llama cuando un cliente está en proceso de volver a conectar automáticamente una sesión con un servidor host de sesión de Escritorio remoto. |
| OnAutoReconnecting2 | Se llama cuando un cliente está en proceso de volver a conectar automáticamente una sesión con un servidor host de sesión de Escritorio remoto. |
| OnChannelReceivedData | Se llama cuando el cliente recibe datos en un canal virtual que admite scripts. |
| OnConfirmClose | Se llama cuando el cliente llama al método IMsRdpClient::RequestClose . |
| OnConnected | Se llama cuando el control de cliente está en proceso de establecer una conexión con un servidor host de sesión de Escritorio remoto. |
| OnConnecting | Se llama cuando el control de cliente comienza a conectarse a un servidor en respuesta a una llamada a IMsTscAx::Connect. |
| OnConnectionBarPullDown | Se llama cuando el usuario se ha arrastrado hacia abajo en la barra de conexión. |
| OnDevicesButtonPressed | Se llama cuando se presiona el botón dispositivos de la barra de conexión. |
| OnDisconnected | Se llama cuando el control de cliente se ha desconectado del servidor host de sesión de Escritorio remoto. |
| OnEnterFullScreenMode | Se llama cuando el cliente entra en modo de pantalla completa. Por ejemplo, se llama a este evento cuando el usuario presiona la combinación de teclas de método abreviado de modo de pantalla completa (CTRL+ALT+BREAK). |
| OnFatalError | Se llama cuando el control de cliente encuentra un error irrecuperable. |
| OnFocusReleased | Se llama cuando se presiona la combinación de teclas de foco de liberación. Por ejemplo, se llama a este evento cuando el usuario presiona la tecla CTRL+ALT+FLECHA IZQUIERDA o la combinación de teclas CTRL+ALT+FLECHA DERECHA. |
| OnIdleTimeoutNotification | Se llama cuando el usuario no ha realizado ninguna entrada del mouse o del teclado durante el período de tiempo establecido por el método IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout . |
| OnLeaveFullScreenMode | Se llama cuando el cliente deja el modo de pantalla completa. Por ejemplo, se llama a este evento cuando el usuario presiona la combinación de teclas de método abreviado de modo de pantalla completa (CTRL+ALT+BREAK). |
| OnLoginComplete | Se llama cuando el control de cliente ha iniciado sesión correctamente en un servidor host de sesión de Escritorio remoto, siguiendo la presentación del cuadro de diálogo Inicio de sesión de Windows. |
| OnLogonError | Se llama cuando se produce un error de inicio de sesión u otro evento de inicio de sesión. |
| OnMouseInputModeChanged | Se llama cuando el modo de entrada del mouse ha cambiado. |
| OnNetworkStatusChanged | Se llama cuando el estado de la red ha cambiado. |
| OnReceivedTSPublicKey | Se llama durante la secuencia de conexión cuando el cliente recupera la clave pública del servidor. Solo se llama a este evento si la propiedad NotifyTSPublicKey está VARIANT_TRUE. |
| OnRemoteDesktopSizeChange | Se llama para indicar que el tamaño del control de cliente en el escritorio remoto ha cambiado en respuesta a una operación de control de cliente. |
| OnRemoteProgramDisplayed | Se llama cuando se muestra un programa RemoteApp. |
| OnRemoteProgramResult | Se llama cuando un programa RemoteApp devuelve un resultado al control de cliente. |
| OnRemoteWindowDisplayed | Se llama cuando se muestra una ventana de RemoteApp. |
| OnRequestContainerMinimize | Se llama cuando el usuario presiona el botón Minimizar en la barra de conexión en modo de pantalla completa. La activación de este evento es una solicitud de que la aplicación contenedora se minimice. |
| OnRequestGoFullScreen | Se llama cuando el cliente solicita cambiar al modo de pantalla completa y se llama al método IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen para establecer la propiedad ContainerHandledFullScreen en un valor distinto de cero. |
| OnRequestLeaveFullScreen | Se llama cuando el cliente solicita dejar el modo de pantalla completa y la propiedad IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen se ha establecido en un valor distinto de cero. |
| OnServiceMessageReceived | Se llama cuando el cliente recibe un mensaje del sistema. |
| OnUserNameAcquired | Se llama cuando el control ha adquirido el nombre de usuario. |
| OnWarning | Se llama cuando el control de cliente encuentra una condición de error que no es grave. |
Observaciones
Para obtener más información sobre la conexión web de Escritorio remoto, consulte Requisitos para la conexión web de Escritorio remoto.
Los objetos de control de cliente RDP (MsRdpClient, MsRdpClientNonScriptable y sus derivados) son objetos conectables. Para recibir eventos del control ActiveX de Escritorio remoto sobre la sesión remota, una aplicación puede implementar IMstscAxEvents y realizar los pasos siguientes.
- Llame a IUnknown::QueryInterface en el objeto de control de cliente RDP para obtener un puntero a la interfaz IConnectionPointContainer .
- Llame a IConnectionPointContainer::FindConnectionPoint, especificando
__uuidof(IMsTscAxEvents)como parámetro riid , para obtener un puntero a la interfaz IConnectionPoint de los eventos de control de cliente. - Llame a IConnectionPoint::Advise para especificar la propia implementación de la aplicación que llama de IMsTscAxEvents donde se van a enviar los eventos.
La aplicación puede usar los siguientes DISPID al implementar IDispatch::Invoke.
| dispIdMember | Distribución al 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 | Ninguno. Proporciona un código de estado VT_UI4 a la aplicación. La aplicación puede pasar el código de estado contenido en 'pDispParams-rgvarg>[0].ulVal'' a IMsRdpClient7::GetStatusText para obtener el texto de estado asociado. |
| 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 | Ninguno. Proporciona un código de evento VT_UI4. Este evento se emite en escenarios de Microsoft Defender Protección de aplicaciones. No se debe emitir durante las operaciones normales. |
| DISPID_ONWOKEUPANDRECONNECTING = 37 | Ninguno. El control ActiveX de Escritorio remoto ya no emite este evento. |
| DISPID_ONLOCATIONREDIRECTIONENABLEDRECEIVED = 39 | Ninguno. Este evento notifica a la aplicación que puede empezar a usar IMsRdpClientNonScriptable6::SendLocation2D o IMsRdpClientNonScriptable6::SendLocation3D su ubicación en el servidor para que la ubicación geográfica del cliente pueda reflejarse en la sesión remota. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_MsRdpClient se define como 791fa017-2de3-492e-acc5-53c67a2b94d0 CLSID_MsRdpClient10 se define como C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting se define como A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient2 se define como 9059F30F-4EB1-4BD2-9FDC-36F43A218F4A CLSID_MsRdpClient2a se define como 971127BB-259F-48C2-BD75-5F97A3331551 CLSID_MsRdpClient2NotSafeForScripting se define como 3523C2FB-4031-44E4-9A3B-F1E94986EE7F CLSID_MsRdpClient3 se define como 7584C670-2274-4EFB-B00B-D6AABA6D3850 CLSID_MsRdpClient3a se define como 6A6F4B83-45C5-4CA9-BDD9-0D81C12295E4 CLSID_MsRdpClient3NotSafeForScripting se define como ACE575FD-1FCF-4074-9401-EBAB990FA9DE CLSID_MsRdpClient4 se define como 4EDCB26C-D24C-4E72-AF07-B576699AC0DE CLSID_MsRdpClient4a se define como 54CE37E0-9834-41AE-9896-4DAB69DC022B CLSID_MsRdpClient4NotSafeForScripting se define como 6AE29350-321B-42BE-BBE5-12FB5270C0DE CLSID_MsRdpClient5 se define como 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2 CLSID_MsRdpClient5NotSafeForScripting se define como 4EB2F086-C818-447E-B32C-C51CE2B30D31 CLSID_MsRdpClient6 se define como 7390F3D8-0439-4C05-91E3-CF5CB290C3D0 CLSID_MsRdpClient6NotSafeForScripting se define como D2EA46A7-C2BF-426B-AF24-E19C44456399 CLSID_MsRdpClient7 se define como A9D7038D-B5ED-472E-9C47-94BEA90A5910 CLSID_MsRdpClient7NotSafeForScripting se define como 54D38BF7-B1EF-4479-9674-1BD6EA465258 CLSID_MsRdpClient8 se define como 5F681803-2900-4C43-A1CC-CF405404A676 CLSID_MsRdpClient8NotSafeForScripting se define como A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9 se define como 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting se define como 8B918B82-7985-4C24-89DF-C33AD2BBFBCD CLSID_MsRdpClientNotSafeForScripting se define como 7CACBD7B-0D99-468F-AC33-22E495C0AFE5 CLSID_MsTscAx se define como 1FB464C8-09BB-4017-A2F5-EB742F04392F CLSID_MsTscAxNotSafeForScripting se define como A41A4187-5A86-4E26-B40A-856F9035D9CB |
| IID |
IID_IMsTscAxEvents se define como 336d5562-efa8-482e-8cb3-c5c0fc7a7db6 |