Interfaz IMsRdpClient8
Proporciona los métodos y propiedades necesarios para configurar y usar el control de cliente. Deriva de la interfaz IMsRdpClient7 .
Miembros
La interfaz IMsRdpClient8 hereda de IMsRdpClient7. IMsRdpClient8 también tiene estos tipos de miembros:
Métodos
La interfaz IMsRdpClient8 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 la descripción del error para los eventos de desconexión de sesión. |
| GetStatusText | Recupera el texto de estado del código de estado especificado. |
| GetVirtualChannelOptions | Recupera las opciones establecidas para un canal virtual. |
| Volver a conectar | Vuelve a conectarse a la sesión remota con el nuevo ancho y alto del escritorio. |
| RequestClose | Solicita un apagado correcto del control ActiveX de Escritorio remoto. |
| 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 CreateVirtualChannels . |
| SendRemoteAction | Hace que se realice una acción en la sesión remota. |
| SetVirtualChannelOptions | Establece las opciones de canal virtual para el control ActiveX de Escritorio remoto. |
Propiedades
La interfaz IMsRdpClient8 tiene estas propiedades.
| Propiedad | Tipo de acceso | Descripción |
|---|---|---|
|
AdvancedSettings |
Solo lectura |
Recupera un puntero de interfaz IMsTscAdvancedSettings . |
|
AdvancedSettings2 |
Solo lectura |
Recupera un puntero a la interfaz IMsRdpClientAdvancedSettings . La interfaz se puede usar para establecer la configuración avanzada para el control de cliente. |
|
AdvancedSettings3 |
Solo lectura |
Recupera un puntero a la interfaz IMsRdpClientAdvancedSettings2 . La interfaz se puede usar para establecer la configuración avanzada para el control de cliente. |
|
AdvancedSettings4 |
Solo lectura |
Recupera un puntero a la interfaz IMsRdpClientAdvancedSettings3 . |
|
AdvancedSettings5 |
Solo lectura |
Recupera un puntero a una interfaz IMsRdpClientAdvancedSettings4 . |
|
AdvancedSettings6 |
Solo lectura |
Recupera la interfaz IMsRdpClientAdvancedSettings5 . |
|
AdvancedSettings7 |
Solo lectura |
Recupera la interfaz IMsRdpClientAdvancedSettings6 . |
|
AdvancedSettings8 |
Solo lectura |
Recupera un objeto que admite la interfaz IMsRdpClientAdvancedSettings7 . |
|
AdvancedSettings9 |
Solo lectura |
Contiene un objeto que admite la interfaz IMsRdpClientAdvancedSettings8 . |
|
CipherStrength |
Solo lectura |
Recupera la máxima intensidad de cifrado del control actual. |
|
ColorDepth |
Lectura/escritura |
Profundidad de color (en bits por píxel) para la conexión del control. |
|
Conectado |
Solo lectura |
Recupera el estado de conexión del control actual. |
|
ConnectedStatusText |
Lectura/escritura |
Contiene el texto que se muestra en el área cliente del control mientras el control está en estado conectado. |
|
ConnectingText |
Lectura/escritura |
Especifica el texto que aparece centrado en el control mientras el control se conecta. |
|
DesktopHeight |
Lectura/escritura |
Especifica el alto del control actual, en píxeles, en el escritorio remoto inicial. |
|
DesktopWidth |
Lectura/escritura |
Especifica el ancho del control actual, en píxeles, en el escritorio remoto inicial. |
|
DisconnectedText |
Lectura/escritura |
Especifica el texto que aparece centrado en el control antes de que finalice una conexión. |
|
Dominio |
Lectura/escritura |
Especifica el dominio en el que inicia sesión el usuario actual. |
|
ExtendedDisconnectReason |
Solo lectura |
Contiene información extendida sobre el motivo de la desconexión del control. |
|
Fullscreen |
Lectura/escritura |
Determina si el control de cliente está en modo de pantalla completa. |
|
FullScreenTitle |
Solo escritura |
Especifica el 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. |
|
MsRdpClientShell |
Solo lectura |
Recupera la interfaz IMsRdpClientShell de la interfaz de configuración de cliente que admite scripts. |
|
RemoteProgram |
Solo lectura |
Recupera un objeto que admite la interfaz ITSRemoteProgram . |
|
RemoteProgram2 |
Solo lectura |
Recupera un objeto que admite la interfaz ITSRemoteProgram2 . |
|
SecuredSettings |
Solo lectura |
Recupera un puntero de interfaz IMsTscSecuredSettings . |
|
SecuredSettings2 |
Solo lectura |
Recupera un puntero a la interfaz IMsRdpClientSecuredSettings . Esta interfaz se puede usar para establecer la configuración protegida para el control de cliente. |
|
SecuredSettings3 |
Solo lectura |
Recupera un objeto que admite la interfaz IMsRdpClientSecuredSettings2 . |
|
SecuredSettingsEnabled |
Solo lectura |
Indica si la interfaz IMsTscSecuredSettings está disponible. Es decir, si la página web que contiene el control se encuentra actualmente en una de las zonas de seguridad de direcciones URL de Internet Explorer permitidas. |
|
Servidor |
Lectura/escritura |
Especifica el nombre del servidor al que está conectado el control actual. |
|
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 |
Recupera lo que se pasó a través de un script a la interfaz IMsRdpClientTransportSettings . |
|
TransportSettings2 |
Solo lectura |
Recupera la interfaz IMsRdpClientTransportSettings2 . |
|
TransportSettings3 |
Solo lectura |
Recupera un objeto que admite la interfaz IMsRdpClientTransportSettings3 . |
|
Nombre de usuario |
Lectura/escritura |
Especifica la credencial de inicio de sesión del nombre de usuario. |
|
Versión |
Solo lectura |
Especifica el número de versión del control actual. |
|
VerticalScrollBarVisible |
Solo lectura |
Indica si el control muestra una barra de desplazamiento vertical. |
Comentarios
La interfaz IMsRdpClient8 se ha ampliado mediante las siguientes interfaces, con cada nueva interfaz que hereda todos los métodos y propiedades de las interfaces anteriores:
Para obtener más información sobre la conexión web de Escritorio remoto, consulte Requisitos para la conexión web de Escritorio remoto.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 8 |
| Servidor mínimo compatible |
Windows Server 2012 |
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_MsRdpClient10 se define como C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting se define como A0C63C30-F08D-4AB4-907C-34905D770C7D 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 |
| IID |
IID_IMsRdpClient8 se define como 4247E044-9271-43A9-BC49-E2AD9E855D62 |