Interfaz IMsRdpClientAdvancedSettings
Administra la configuración avanzada del cliente. Deriva de la interfaz IMsTscAdvancedSettings . Esta interfaz incluye métodos para recuperar y establecer propiedades avanzadas (opcionales) para el control ActiveX de Escritorio remoto.
Para obtener una instancia de esta interfaz, use la propiedad IMsTscAx::AdvancedSettings para obtener un puntero de interfaz IMsTscAdvancedSettings . A continuación, llame a QueryInterface en el puntero IMsTscAdvancedSettings y pase IID_IMsRdpClientAdvancedSettings a QueryInterface.
Miembros
La interfaz IMsRdpClientAdvancedSettings hereda de IMsTscAdvancedSettings. IMsRdpClientAdvancedSettings también tiene estos tipos de miembros:
Propiedades
La interfaz IMsRdpClientAdvancedSettings tiene estas propiedades.
| Propiedad | Tipo de acceso | Descripción |
|---|---|---|
| AcceleratorPassthrough |
Lectura/escritura |
Especifica si se deben pasar aceleradores de teclado al servidor. |
| BitmapCacheSize |
Lectura/escritura |
Tamaño, en kilobytes, del archivo de caché de mapa de bits usado para mapas de bits de 8 bits por píxel. Los valores numéricos válidos de esta propiedad son de 1 a 32 inclusive. |
| BitmapPersistence |
Lectura/escritura |
Especifica si se debe usar el almacenamiento en caché del mapa de bits persistente. El almacenamiento en caché persistente puede mejorar el rendimiento, pero requiere espacio en disco adicional. |
| BitmapVirtualCache16BppSize |
Lectura/escritura |
Especifica el tamaño, en megabytes, del archivo de caché de mapa de bits persistente que se va a usar para la configuración de color alto de 15 y 16 bits por píxel. |
| BitmapVirtualCache24BppSize |
Lectura/escritura |
Especifica el tamaño, en megabytes, del archivo de caché de mapa de bits persistente que se va a usar para la configuración de color alto de 24 bits por píxel. |
| BitmapVirtualCacheSize |
Lectura/escritura |
Especifica el tamaño, en megabytes, del archivo de caché de mapa de bits persistente que se va a usar para el color de 8 bits por píxel. Los valores numéricos válidos de esta propiedad son de 1 a 32 inclusive. Tenga en cuenta que el tamaño máximo de todos los archivos de caché virtual es de 128 MB. Las propiedades relacionadas incluyen las propiedades BitmapVirtualCache16BppSize y BitmapVirtualCache24BppSize . |
| brushSupportLevel |
Lectura/escritura |
Esta propiedad no es compatible. |
| CachePersistenceActive |
Lectura/escritura |
Especifica si se debe usar el almacenamiento en caché del mapa de bits persistente. |
| ClearTextPassword |
Solo escritura |
Especifica la contraseña con la que se va a conectar. Para obtener más información, consulte la interfaz IMsTscNonScriptable . |
| ConnectToServerConsole |
Lectura/escritura |
Esta propiedad no es compatible. |
| ConnectWithEndpoint |
Solo escritura |
Esta propiedad no es compatible. |
| DedicatedTerminal |
Lectura/escritura |
Esta propiedad no es compatible. |
| DisableCtrlAltDel |
Lectura/escritura |
Especifica si se debe mostrar la pantalla explicativa inicial de Winlogon. |
| DisplayConnectionBar |
Lectura/escritura |
Especifica si se va a usar la barra de conexión. El valor predeterminado es VARIANT_TRUE, lo que habilita la propiedad . |
| DoubleClickDetect |
Lectura/escritura |
Especifica si el cliente identifica los doble clics del servidor. |
| EnableMouse |
Lectura/escritura |
Esta propiedad no es compatible. |
| EnableWindowsKey |
Lectura/escritura |
Especifica si la clave de Windows se puede usar en la sesión remota. |
| EncryptionEnabled |
Lectura/escritura |
Esta propiedad no es compatible. No se puede deshabilitar el cifrado. |
| GrabFocusOnConnect |
Lectura/escritura |
Especifica si el control de cliente debe tener el foco al conectarse. |
| HotKeyAltEsc |
Lectura/escritura |
Especifica el código de clave virtual que se va a agregar a ALT para determinar el reemplazo de teclas de acceso rápido para ALT+ESC. VK_INSERT es el valor predeterminado, con ALT+INSERT como secuencia resultante. Esta propiedad solo es válida cuando la propiedad KeyboardHookMode no está habilitada. |
| HotKeyAltShiftTab |
Lectura/escritura |
Especifica el código de clave virtual que se va a agregar a ALT para determinar el reemplazo de teclas de acceso rápido para ALT+MAYÚS+TAB. VK_NEXT es el valor predeterminado, con ALT+PAGE DOWN como secuencia resultante. Esta propiedad solo es válida cuando la propiedad KeyboardHookMode no está habilitada. |
| HotKeyAltSpace |
Lectura/escritura |
Especifica el código de clave virtual que se va a agregar a ALT para determinar el reemplazo de teclas de acceso rápido para ALT+SPACE. VK_DELETE es el valor predeterminado, con ALT+DELETE como secuencia resultante. Esta propiedad solo es válida cuando la propiedad KeyboardHookMode no está habilitada. |
| HotKeyAltTab |
Lectura/escritura |
Especifica el código de clave virtual que se va a agregar a ALT para determinar el reemplazo de teclas de acceso rápido para ALT+TAB. VK_PRIOR es el valor predeterminado, con ALT+PAGE UP como secuencia resultante. Esta propiedad solo es válida cuando la propiedad KeyboardHookMode no está habilitada. |
| HotKeyCtrlAltDel |
Lectura/escritura |
Especifica el código de clave virtual que se va a agregar a CTRL+ALT para determinar el reemplazo de teclas de acceso rápido para CTRL+ALT+DELETE, también denominado secuencia de atención segura (SAS). VK_END es el valor predeterminado. Tenga en cuenta que incluso cuando la propiedad KeyboardHookMode está habilitada, CTRL+ALT+DELETE nunca se redirige al servidor remoto; CTRL+ALT+DELETE es la secuencia SAS local. |
| HotKeyCtrlEsc |
Lectura/escritura |
Especifica el código de clave virtual que se va a agregar a ALT para determinar el reemplazo de teclas de acceso rápido para CTRL+ESC. VK_HOME es el valor predeterminado, con ALT+HOME como secuencia resultante. Esta propiedad solo es válida cuando la propiedad KeyboardHookMode no está habilitada. |
| HotKeyFullScreen |
Lectura/escritura |
Especifica el código de clave virtual que se va a agregar a CTRL+ALT para determinar el reemplazo de la tecla de acceso rápido para cambiar al modo de pantalla completa. VK_CANCEL es el valor predeterminado. |
| InputEventsAtOnce |
Lectura/escritura |
Esta propiedad no es compatible. |
| keepAliveInterval |
Lectura/escritura |
Especifica un intervalo, en milisegundos, en el que el cliente envía mensajes de mantenimiento activo al servidor. El valor predeterminado de la propiedad es cero, lo que deshabilita los mensajes de mantenimiento activo. El valor mínimo válido de esta propiedad es 10 000, que representa 10 segundos. Tenga en cuenta que una configuración de directiva de grupo que especifica si se permiten conexiones de cliente persistentes al servidor puede invalidar esta configuración de propiedad. |
| KeyboardFunctionKey |
Lectura/escritura |
Válido solo para Windows CE. |
| KeyboardSubType |
Lectura/escritura |
Válido solo para Windows CE. |
| KeyboardType |
Lectura/escritura |
Válido solo para Windows CE. |
| LoadBalanceInfo |
Lectura/escritura |
Especifica la cookie de equilibrio de carga que se colocará en el paquete de solicitud de conexión X.224 en la secuencia de conexión del protocolo del servidor host de sesión de Escritorio remoto. |
| maxEventCount |
Lectura/escritura |
Esta propiedad no es compatible. |
| MaximizarShell |
Lectura/escritura |
Especifica si los programas iniciados con la propiedad StartProgram deben maximizarse. |
| minInputSendInterval |
Lectura/escritura |
Especifica el intervalo mínimo, en milisegundos, entre el envío de eventos del mouse. |
| MinutesToIdleTimeout |
Lectura/escritura |
Especifica el período máximo de tiempo, en minutos, que el cliente debe permanecer conectado sin la entrada del usuario. Si transcurre el tiempo especificado, el control llama al método IMsTscAxEvents::OnIdleTimeoutNotification . |
| NotifyTSPublicKey |
Lectura/escritura |
Esta propiedad no es compatible. |
| NumBitmapCaches |
Lectura/escritura |
Esta propiedad no es compatible. |
| orderDrawThreshold |
Lectura/escritura |
Esta propiedad no es compatible. |
| overallConnectionTimeout |
Lectura/escritura |
Especifica el tiempo total, en segundos, que el control de cliente espera a que se complete una conexión. El valor máximo válido de esta propiedad es 600, que representa 10 minutos. Si el tiempo especificado transcurre antes de que se complete la conexión, el control se desconecta y llama al método IMsTscAxEvents::OnDisconnected . Una propiedad relacionada es singleConnectionTimeout. |
| PerformanceFlags |
Lectura/escritura |
Especifica un conjunto de características que se pueden establecer en el servidor para mejorar el rendimiento. |
| PersistCacheDirectory |
Solo escritura |
Esta propiedad no es compatible. |
| PinConnectionBar |
Lectura/escritura |
Especifica el estado de la barra de conexión de la interfaz de usuario. Al establecer esta propiedad en VARIANT_TRUE se establece el estado en "lowered", es decir, invisible para el usuario y no disponible para la entrada. VARIANT_FALSE establece el estado en "elevado" y disponible para la entrada del usuario. |
| RdpdrClipCleanTempDirString |
Lectura/escritura |
Esta propiedad no es compatible. |
| RdpdrClipPasteInfoString |
Lectura/escritura |
Esta propiedad no es compatible. |
| RdpdrLocalPrintingDocName |
Lectura/escritura |
Esta propiedad no es compatible. |
| RDPPort |
Lectura/escritura |
Especifica el puerto de conexión. El valor predeterminado es 3389. |
| RedirectDrives |
Lectura/escritura |
Especifica si se permite la redirección de unidades de disco. |
| RedirectPorts |
Lectura/escritura |
Especifica si se permite el redireccionamiento de puertos locales (por ejemplo, COM y LPT). |
| RedirectPrinters |
Lectura/escritura |
Especifica si se permite la redirección de impresoras. |
| RedirectSmartCards |
Lectura/escritura |
Especifica si se permite la redirección de tarjetas inteligentes. |
| SasSequence |
Lectura/escritura |
Especifica la secuencia de acceso seguro que usará el cliente para acceder a la pantalla de inicio de sesión en el servidor. |
| ScaleBitmapCachesByBPP |
Lectura/escritura |
Esta propiedad no es compatible. |
| ShadowBitmap |
Lectura/escritura |
Esta propiedad no es compatible. Windows Vista: Especifica si se deben usar mapas de bits de sombra. |
| shutdownTimeout |
Lectura/escritura |
Especifica el período de tiempo, en segundos, para esperar a que el servidor responda a una solicitud de desconexión. El valor predeterminado de la propiedad es 10. El valor máximo válido de la propiedad es 600, que representa 10 minutos. Si el servidor no responde dentro del tiempo especificado, el control de cliente se desconecta. |
| singleConnectionTimeout |
Lectura/escritura |
Especifica el período máximo de tiempo, en segundos, que el control de cliente espera para una conexión a una dirección IP. Durante la conexión, el control puede intentar conectarse a varias direcciones IP. El valor máximo válido de esta propiedad es 600. Una propiedad relacionada es overallConnectionTimeout. |
| SmartSizing |
Lectura/escritura |
Especifica si se debe escalar la pantalla para ajustarse al área cliente del control. VARIANT_TRUE habilita el escalado. Tenga en cuenta que las barras de desplazamiento no aparecen cuando la propiedad SmartSizing está habilitada. |
| SmoothScroll |
Lectura/escritura |
Esta propiedad no es compatible. |
| TransportType |
Lectura/escritura |
Especifica el tipo de transporte utilizado por el cliente. El control ActiveX de Escritorio remoto no usa esta propiedad. |
| WinCEFixedPalette |
Lectura/escritura |
Válido solo para Windows CE. |
Comentarios
Esta interfaz se ha ampliado mediante las siguientes interfaces, con cada nueva interfaz que hereda todos los métodos y propiedades de las interfaces anteriores:
- IMsRdpClientAdvancedSettings2
- IMsRdpClientAdvancedSettings3
- IMsRdpClientAdvancedSettings4
- IMsRdpClientAdvancedSettings5
- IMsRdpClientAdvancedSettings6
- IMsRdpClientAdvancedSettings7
- IMsRdpClientAdvancedSettings8
Esta propiedad no se puede establecer cuando el control está conectado, a menos que se indique lo contrario.
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 Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Biblioteca de tipos |
|
| Archivo DLL |
|
| IID |
IID_IMsRdpClientAdvancedSettings se define como 3c65b4ab-12b3-465b-acd4-b8dad3bff9e2 |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de