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

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.

1. Llame a IUnknown::QueryInterface en el objeto de control de cliente RDP para obtener un puntero a la interfaz IConnectionPointContainer .
2. 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.
3. 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	MsTscAx.dll
Archivo DLL	MsTscAx.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

Consulte también

IDispatch

Referencia de conexión web de Escritorio remoto