Clase MsRdpClient12NotSafeForScripting
Control de cliente RDP de Microsoft: versión 13
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
- IMsRdpClientNonScriptable6
- IMsRdpClientNonScriptable7
- IMsRdpClientNonScriptable8
- IMsRdpPreferredRedirectionInfo
- IMsRdpExtendedSettings
MsRdpClient12NotSafeForScripting tiene estos tipos de miembros:
Métodos
La clase MsRdpClient12NotSafeForScripting 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 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. |
| 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 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 . |
| 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. |
| SendLocation2D | Envía un valor de latitud y longitud al servidor para que la ubicación geográfica del cliente se pueda reflejar en la sesión remota. |
| SendLocation3D | Envía un valor de latitud, longitud y altitud al servidor para que la ubicación geográfica del cliente se pueda reflejar en la sesión remota. |
| DisableDpiCursorScalingForProcess | Deshabilita el escalado local del cursor del mouse recibido del servidor, lo que garantiza que la forma del cursor se represente correctamente sin modificaciones. |
| StartWorkspaceExtension | Coordina la sesión remota del cliente con el panel de control RemoteApp y Conexiones de escritorio. |
Propiedades
La clase MsRdpClient12NotSafeForScripting 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 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 conocer las funcionalidades de RemoteApp. |
|
DisconnectedText |
Lectura/escritura |
Texto que aparece centrado en el control antes de que finalice una conexión. |
|
Domain |
Lectura/escritura |
Dominio en el que el usuario actual inicia sesión. |
|
DriveCollection |
Solo lectura |
Colección de unidades de disco que está disponible 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 la configuración NegotiateSecurityLayer es compatible con esta conexión. Nota: Cuando CredSspSupport está habilitado y presente en el cliente, o cuando capa de sockets seguros (SSL) está habilitado con la 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 de solicitud de credenciales. |
|
PromptForCredsOnClient |
Lectura/escritura |
Especifica si el control de cliente muestra un cuadro de diálogo que solicita las credenciales. |
|
Propiedad |
Lectura/escritura |
Contiene una propiedad con nombre. |
|
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 se encuentran 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 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. |
|
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 |
Si se va a usar el nombre del servidor de redireccionamiento. |
|
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. |
|
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 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. |
| CameraRedirConfigCollection | Solo lectura | Obtiene la colección de cámaras (y las configuraciones asociadas) que están disponibles para el redireccionamiento. |
| Portapapeles | Solo lectura | Obtiene el controlador del Portapapeles que se usa para sincronizar los Portapapeles locales y remotos si está habilitada la sincronización manual del Portapapeles. |
| CorrelationId | Solo lectura | Obtiene un GUID que identifica de forma única la sesión remota del cliente. |
| SupportsWorkspaceReconnect | Solo escritura | Informa al control ActiveX de Escritorio remoto de que la sesión remota del cliente forma parte de una conexión en el panel de control Conexiones de Escritorio y RemoteApp que admite la reconexión. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 10 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2016 |
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_MsRdpClient12NotSafeForScripting se define como 3F859A3-C2D4-4FAA-B0E4-FD0C9C4E5E3A |