Clase MsRdpClient6

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

Esta clase implementa las interfaces siguientes.

MsRdpClient6 tiene estos tipos de miembros:

Métodos

La clase MsRdpClient6 tiene estos métodos.

Método Descripción
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.
Desconectar Desconecta la conexión activa.
GetErrorDescription Recupera los códigos de error y los mensajes de error.
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 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.
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 es 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 creado anteriormente mediante el método IMsTscAx::CreateVirtualChannels .
SetVirtualChannelOptions Establece las opciones de canal virtual para el control de cliente.

Propiedades

La clase MsRdpClient6 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.
AllowCredentialSaving
Lectura/escritura
Especifica si el cuadro de diálogo credenciales muestra una casilla para habilitar el guardado de 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
Contraseña de 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.
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.
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.
RemoteProgram
Solo lectura
Configuración de RemoteApp del cliente.
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.
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 redireccionamiento 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 del cliente.
TransportSettings2
Solo lectura
Interfaz a IMsRdpClientTransportSettings2.
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.
Nombre de usuario
Lectura/escritura
Credencial de inicio de sesión del 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.
WarnAboutPrinterRedirection
Lectura/escritura
Especifica si el cuadro de diálogo de redirección muestra un mensaje sobre la redirección 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 Vista
Servidor mínimo compatible
Windows Server 2008
Biblioteca de tipos
MsTscAx.dll
Archivo DLL
MsTscAx.dll
CLSID
CLSID_MsRdpClient6 se define como 7390F3D8-0439-4C05-91E3-CF5CB290C3D0

Consulte también

Clases de control ActiveX de Escritorio remoto