Clase MsRdpClient10

Control de cliente RDP de Microsoft (redistribuible): versión 11

Esta clase implementa las siguientes interfaces.

• IMsRdpClient10
• IMsRdpClient9
• IMsRdpClient8
• IMsRdpClient7
• IMsRdpClient6
• IMsRdpClient5
• IMsRdpClient4
• IMsRdpClient3
• IMsRdpClient2
• IMsRdpClient
• IMsTscAx
• IDispatch
• IMsTscAxEvents
• IMsTscNonScriptable
• IMsRdpClientNonScriptable
• IMsRdpClientNonScriptable2
• IMsRdpClientNonScriptable3
• IMsRdpClientNonScriptable4
• IMsRdpClientNonScriptable5
• IMsRdpPreferredRedirectionInfo

MsRdpClient10 tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

La clase MsRdpClient10 tiene estos métodos.

Método	Descripción
attachEvent	Adjunta un evento.
Conectar	Inicia una conexión mediante las propiedades establecidas actualmente en el control .
CreateVirtualChannels	Crea un objeto de canal virtual del lado cliente para cada nombre de canal virtual especificado.
detachEvent	Desasocia un evento.
Desconectar	Desconecta la conexión activa.
GetErrorDescription	Recupera los códigos de error y los mensajes de error.
GetStatusText	Recupera el texto de estado del código de estado especificado.
GetVirtualChannelOptions	Recupera las opciones establecidas para un canal virtual.
NotifyRedirectDeviceChange	Notifica al módulo de redirección de dispositivos del control ActiveX de Escritorio remoto que se ha producido un cambio de dispositivo en el sistema. Este método pasa WM_DEVICECHANGE notificaciones al control .
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 introducido ningún mouse o 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 le 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. Este evento solo se llama si la propiedad NotifyTSPublicKey es VARIANT_TRUE.
OnRemoteDesktopSizeChange	Se llama a 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 que la aplicación contenedora se minimiza.
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.
Volver a conectar	Vuelve a conectarse a la sesión remota con el nuevo ancho y alto del escritorio.
RequestClose	Solicita un cierre correcto del control de cliente.
ResetPassword	Restablece todos los estados de contraseña del control.
SendKeys	Envía una serie de pulsaciones de tecla al control . Las pulsaciones de tecla están en formato de código de examen, que son los datos del teclado de las teclas físicas reales.
SendOnVirtualChannel	Envía datos al servidor host de sesión de Escritorio remoto a través de un canal virtual que se creó anteriormente mediante el método IMsTscAx::CreateVirtualChannels .
SendRemoteAction	Hace que se realice una acción en la sesión remota.
SetVirtualChannelOptions	Establece las opciones de canal virtual para el control de cliente.
SyncSessionDisplaySettings	Sincroniza la configuración de visualización de la sesión.
UpdateSessionDisplaySettings	Novedades configuración de visualización de la sesión.

Propiedades

La clase MsRdpClient10 tiene estas propiedades.

Propiedad	Tipo de acceso	Descripción
AdvancedSettings	Solo lectura	Puntero de interfaz IMsTscAdvancedSettings .
AdvancedSettings2	Solo lectura	Puntero a la interfaz IMsRdpClientAdvancedSettings , que se usa para establecer la configuración avanzada para el control de cliente.
AdvancedSettings3	Solo lectura	Puntero a la interfaz IMsRdpClientAdvancedSettings2 , que se usa para establecer la configuración avanzada para el control de cliente.
AdvancedSettings4	Solo lectura	Puntero a la interfaz IMsRdpClientAdvancedSettings3 , que se usa para establecer la configuración avanzada para el control de cliente.
AdvancedSettings5	Solo lectura	Puntero de interfaz IMsRdpClientAdvancedSettings4 .
AdvancedSettings6	Solo lectura	Interfaz de IMsRdpClientAdvancedSettings5.
AdvancedSettings7	Solo lectura	Interfaz para IMsRdpClientAdvancedSettings6.
AdvancedSettings8	Solo lectura	Objeto que admite la interfaz IMsRdpClientAdvancedSettings7 .
AdvancedSettings9	Solo lectura	Interfaz IMsRdpClientAdvancedSettings8 que representa el objeto de configuración.
AllowCredentialSaving	Lectura/escritura	Especifica si el cuadro de diálogo de credenciales muestra una casilla para habilitar el guardado de credenciales.
AllowPromptingForCredentials	Lectura/escritura	Especifica si el control ActiveX de Escritorio remoto puede solicitar al usuario las credenciales.
BinaryPassword	Lectura/escritura	Esta propiedad no es compatible.
BinarySalt	Lectura/escritura	Esta propiedad no es compatible.
CipherStrength	Solo lectura	La máxima intensidad de cifrado del control actual.
ClearTextPassword	Solo escritura	La contraseña del control ActiveX de Escritorio remoto, en formato de texto no cifrado.
ColorDepth	Lectura/escritura	Profundidad de color del control actual.
Conectado	Solo lectura	Estado de conexión del control actual.
ConnectedStatusText	Lectura/escritura	Texto que se muestra en el área cliente del control mientras el control está en estado conectado.
ConnectingText	Lectura/escritura	Texto que aparece centrado en el control mientras el control se conecta.
ConnectionBarText	Lectura/escritura	Cadena de texto que se va a mostrar para la barra de conexión.
DesktopHeight	Lectura/escritura	Alto del control actual, en píxeles, en el escritorio remoto inicial.
DesktopWidth	Lectura/escritura	Ancho del control actual, en píxeles, en el escritorio remoto inicial.
DeviceCollection	Solo lectura	Colección de dispositivos PnP que están disponibles para el redireccionamiento.
DisableConnectionBar	Solo escritura	Especifica si el control ActiveX de Escritorio remoto debe deshabilitar la barra de conexión.
DisableRemoteAppCapsCheck	Lectura/escritura	Especifica si el control ActiveX de Escritorio remoto no debe comprobar el servidor para las funcionalidades de RemoteApp.
DisconnectedText	Lectura/escritura	Texto que aparece centrado en el control antes de que finalice una conexión.
Dominio	Lectura/escritura	Dominio en el que inicia sesión el usuario actual.
DriveCollection	Solo lectura	Colección de unidades de disco disponibles para el redireccionamiento.
EnableCredSspSupport	Lectura/escritura	Especifica si CredSSP está habilitado para esta conexión.
ExtendedDisconnectReason	Solo lectura	Información extendida sobre el motivo de la desconexión del control de cliente.
Fullscreen	Lectura/escritura	Indica si el control está en modo de pantalla completa.
FullScreenTitle	Solo escritura	Título de la ventana que se muestra cuando el control está en modo de pantalla completa.
GetRemoteMonitorsBoundingBox	Solo lectura	Especifica el rectángulo delimitador del monitor remoto.
HorizontalScrollBarVisible	Solo lectura	Indica si el control ha mostrado una barra de desplazamiento horizontal.
LaunchedViaClientShellInterface	Lectura/escritura	Especifica si el usuario inició el control de cliente mediante la interfaz de Acceso web de Escritorio remoto.
MarkRdpSettingsSecure	Lectura/escritura	Especifica si la configuración de RDP se marca como segura.
MsRdpClientShell	Solo lectura	Configuración de cliente para el iniciador del portal web.
NegotiateSecurityLayer	Lectura/escritura	Especifica si se admite la configuración NegotiateSecurityLayer para esta conexión. Nota: Cuando CredSspSupport está habilitado y presente en el cliente, o cuando capa de sockets seguros (SSL) está habilitado con autenticación de usuario, se omite NegotiateSecurityLayer.
PortablePassword	Lectura/escritura	Esta propiedad no es compatible.
PortableSalt	Lectura/escritura	Esta propiedad no es compatible.
PromptForCredentials	Lectura/escritura	Especifica si se debe mostrar el cuadro de diálogo solicitar credenciales.
PromptForCredsOnClient	Lectura/escritura	Especifica si el control de cliente muestra un cuadro de diálogo que solicita credenciales.
PublisherCertificateChain	Lectura/escritura	Especifica la cadena de certificados del publicador. La cadena se almacena en una variante de tipo VT_BYREF que contiene un puntero a una estructura CERT_CHAIN_CONTEXT .
RedirectDynamicDevices	Lectura/escritura	Especifica si los dispositivos PnP conectados dinámicamente que se enumeran mientras están en una sesión están disponibles para el redireccionamiento.
RedirectDynamicDrives	Lectura/escritura	Especifica si las unidades PnP conectadas dinámicamente que se enumeran mientras se encuentran en una sesión están disponibles para el redireccionamiento.
RedirectionWarningType	Lectura/escritura	Controla la presencia y apariencia del cuadro de diálogo de redireccionamiento.
RemoteMonitorCount	Solo lectura	Especifica el número de monitores remotos.
RemoteMonitorLayoutMatchesLocal	Solo lectura	Especifica si el diseño del monitor remoto es idéntico al diseño del monitor local.
RemoteProgram	Solo lectura	Configuración de RemoteApp del cliente.
RemoteProgram2	Solo lectura	Objeto que admite la interfaz ITSRemoteProgram2 .
RemoteProgram3	Solo lectura	Objeto que admite la interfaz ITSRemoteProgram3 .
SecuredSettings	Solo lectura	Puntero de interfaz IMsTscSecuredSettings .
SecuredSettings2	Solo lectura	Puntero a la interfaz IMsRdpClientSecuredSettings , que se usa para establecer la configuración segura para el control de cliente.
SecuredSettings3	Solo lectura	Objeto que admite la interfaz IMsRdpClientSecuredSettings2 .
SecuredSettingsEnabled	Solo lectura	Indica si la interfaz IMsTscSecuredSettings está disponible.
Servidor	Lectura/escritura	Nombre del servidor al que está conectado el control actual.
ShowRedirectionWarningDialog	Lectura/escritura	Especifica si se debe mostrar el cuadro de diálogo de advertencia de seguridad de redirección antes de iniciar una sesión.
StartConnected	Lectura/escritura	Indica si el control establecerá la conexión del servidor host de sesión de Escritorio remoto inmediatamente después del inicio.
TransportSettings	Solo lectura	Configuración de puerta de enlace de Escritorio remoto de cliente.
TransportSettings2	Solo lectura	Interfaz de IMsRdpClientTransportSettings2.
TransportSettings3	Solo lectura	Objeto que admite la interfaz IMsRdpClientTransportSettings3 .
TransportSettings4	Solo lectura	Objeto que admite la interfaz IMsRdpClientTransportSettings4 .
TrustedZoneSite	Lectura/escritura	Especifica si el sitio web desde el que el usuario inició la conexión está en la lista de sitios de confianza del equipo cliente.
UIParentWindowHandle	Lectura/escritura	Identificador de ventana que va a ser la ventana primaria del control. Esto permite que las ventanas mostradas por el control sean modales correctamente con respecto a las ventanas mostradas por la aplicación primaria.
UseMultimon	Lectura/escritura	Especifica si el control ActiveX de Escritorio remoto debe usar varios monitores.
UseRedirectionServerName	Lectura/escritura	Indica si se debe usar el nombre del servidor de redireccionamiento.
Nombre de usuario	Lectura/escritura	Credencial de inicio de sesión de nombre de usuario.
Versión	Solo lectura	Número de versión del control actual.
VerticalScrollBarVisible	Solo lectura	Indica si el control muestra una barra de desplazamiento vertical.
WarnAboutClipboardRedirection	Lectura/escritura	Especifica si el cuadro de diálogo de advertencia de seguridad debe incluir una advertencia sobre el redireccionamiento del Portapapeles antes de iniciar una sesión.
WarnAboutDirectXRedirection	Lectura/escritura	No se usa esta propiedad.
WarnAboutPrinterRedirection	Lectura/escritura	Especifica si el cuadro de diálogo de redirección muestra un mensaje sobre el redireccionamiento de impresora antes de iniciar una sesión.
WarnAboutSendingCredentials	Lectura/escritura	Especifica si la advertencia de seguridad debe incluir una advertencia sobre el envío de credenciales al servidor remoto antes de iniciar una sesión.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016
Biblioteca de tipos	MsTscAx.dll
Archivo DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient10 se define como C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24

Consulte también

Clases de control ActiveX de Escritorio remoto