Propiedad IMsRdpExtendedSettings::P roperty
Contiene una propiedad con nombre.
Esta propiedad es de lectura y escritura.
Sintaxis
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
Valor de propiedad
Valor de propiedad con nombre.
| Nombre de propiedad | Tipo de dato | Acceso | Se puede cambiar después de iniciar la conexión | Descripción |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | Lectura y escritura | Sí | Establecer esta propiedad en True hace que el control de cliente se conecte a la sesión secundaria en el equipo local en lugar de a un servidor remoto. Si esta propiedad se establece en true, no puede conectarse a un servidor remoto porque todas las conexiones se redirigen a localhost. Para obtener más información sobre las sesiones secundarias, consulte sesiones secundarias. |
| DisableCredentialsDelegation | VT_BOOL | Lectura y escritura | No | Si True, las credenciales no se envían al servidor remoto. |
| EnableFrameBufferRedirection | VT_BOOL | Lectura y escritura | No | Si True, se intenta la redirección del búfer de fotogramas. Para una conexión de bucle invertido (el mismo equipo es el cliente y el servidor), el redireccionamiento del búfer de fotogramas permite compartir la memoria del búfer de fotogramas entre las sesiones. |
| EnableHardwareMode | VT_BOOL | Solo escritura | No | Si True, se intenta la ayuda de hardware con la descodificación de gráficos. |
| IgnoreCursors | VT_BOOL | Solo escritura | No | Si True, se omiten los cursores enviados por el servidor remoto. |
| ManualClipboardSyncEnabled | VT_BOOL | Lectura y escritura | Sí | Establecer esta propiedad en True significa que los Portapapeles locales y remotos no se mantendrán sincronizados automáticamente. En su lugar, el IMsRdpClipboard interfaz debe usarse para sincronizar los formatos del Portapapeles desde el Portapapeles local al Portapapeles remoto y al Portapapeles remoto al Portapapeles local. |
| ZoomLevel | * VT_UI4 | Lectura y escritura | Sí | Implementa la característica Zoom mediante el control ACTIVEX RDP. La característica Zoom está disponible en el menú sistema de |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | No | Si True, esto hace que las conexiones de RemoteApp vuelvan a la barra de idioma heredada de antes de Windows 8, en lugar de sincronizar automáticamente el idioma local con la sesión remota. |
| RedirectTextProcessing | VT_BOOL | W | No | A partir de Windows 11 23H2, habilita o deshabilita la redirección del procesamiento de texto que proporciona una experiencia local similar para escenarios de entrada de texto, por ejemplo, IME, emoticons. |
| HvSocketServiceId | VT_BSTR | W | No | Especifica el campo ServiceId del socket de Hyper-Vdirección donde se va a enviar el tráfico RDP. |
| DeviceScaleFactor | VT_UI4 | R/W | No | Especifica el factor de escala de dispositivos que se usa en la sesión remota. Valores válidos: 100, 140, 180 |
| EnableLocationRedirection | VT_BOOL | R/W | No | Habilita o deshabilita la redirección de la ubicación de la máquina local a la sesión remota. |
| AudioCaptureDevice | VT_BSTR | R/W | No | Especifica el identificador de dispositivo del dispositivo de captura de audio para redirigir desde el cliente a la sesión remota. Las aplicaciones pueden usar el mensaje DRV_QUERYFUNCTIONINSTANCEID para determinar el identificador de dispositivo del dispositivo de captura de audio para redirigir. Como alternativa, se puede establecer en "valor predeterminado" para usar el dispositivo predeterminado o ""none"" para deshabilitar la captura de audio. De forma predeterminada, se establece en "default". |
| RailMode | VT_BOOL | R | No | Informa de si se trata de una conexión a RemoteApp. ITSRemoteProgram::RemoteProgramMode escribe en esta propiedad. |
| EnableRdsAadAuth | VT_BOOL | W | No | Si True, se usa de seguridad de autenticación de AAD de RDS. |
| RDGIsKDCProxy | VT_BOOL | W | No | Si True, indica al cliente que use la puerta de enlace de Escritorio remoto (si se especifica) como un servidor proxy KDC de . |
| UseURCP | VT_BOOL | R/W | No | Si True, esta propiedad habilita el Protocolo de control de frecuencia universal para las conexiones de Escritorio remoto basadas en UDP. Actualmente, está deshabilitado de forma predeterminada. Se recomienda habilitarlo si UDP está en uso. |
| DesktopScaleFactor | VT_UI4 | R/W | No | Especifica el factor de escala de dispositivos que se usa en la sesión remota. El valor debe estar comprendido entre 100 y 500 (porcentaje). |
| RedirectedAuthentication | VT_BOOL | W | No | Si True, de Credential Guard remoto está habilitado. |
| RestrictedLogon | VT_BOOL | W | No | Si True, modo de administrador restringido está habilitado. |
| AudioPlaybackDevice | VT_BSTR | R/W | No | Especifica el identificador de dispositivo del dispositivo de reproducción de audio en el equipo local. Las aplicaciones pueden usar el mensaje de DRV_QUERYFUNCTIONINSTANCEID para determinar el identificador de dispositivo del dispositivo de reproducción de audio para redirigir. "Como alternativa, esto se puede establecer en ""default"" para usar el dispositivo predeterminado o ""none"" para deshabilitar la reproducción de audio. De forma predeterminada, se establece en ""default"". " |
| SelectedMonitors | VT_BSTR | R/W | No | Lista delimitada por comas o delimitada por columnas de identificador de monitor para identificar los monitores seleccionados donde mostrar la sesión remota. El primer identificador de la lista se tratará como el monitor principal en la sesión remota. |
| WslgModeEnabled | VT_BOOL | W | No | Si True, la sesión es una sesión WSLg. Se espera que se proporcionen las siguientes propiedades:
Consulte la documentación de WSLg https://github.com/microsoft/wslg. |
| ShowSessionDiagnostics | VT_BOOL | W | Sí | Escribir True en esta propiedad muestra inmediatamente un cuadro de diálogo con información detallada sobre la sesión remota. Esta propiedad está pensada para ser un mecanismo de depuración. Está sujeto a cambios y eliminación. |
| PrintingProgressMode | VT_UI4 | R/W | No | Valores posibles:
|
| CorrelationId | VT_BOOL | W | No | Invalida el valor devuelto por IMsRdpClientNonScriptable8::CorrelationId. |
| RequestUseNewOutputPresenter | VT_BOOL | W | No | Si True, la sesión remota solo se presenta mediante DirectX sin reserva a GDI. Esta propiedad no se aplica a las sesiones remotas de la aplicación. Nota: esta propiedad está sujeta a la eliminación en versiones futuras de Windows, ya que el modo de solo DirectX podría convertirse en la única opción disponible. Actualmente se trata de una característica en versión preliminar que no debe estar habilitada en el código de producción. |
| GatewayCertificateLogonAuthority | VT_BSTR | W | No | Esta propiedad ya no se admite. Está sujeto a eliminación en versiones futuras de Windows. No use esta propiedad. |
| EnableRemoteEdgeBar | VT_BOOL | R/W | No | Si |
| TSGTransportIsUsed | VT_BOOL | R | N/A | Si True, se usa una puerta de enlace de Escritorio remoto para la sesión remota asociada. |
| DiagnosticsInfo | VT_BSTR | W | No | Cadena hexadecimal que representa el campo rdpCorrelationInfo.correlationId del cliente X.224 Connection Request PDU. |
| EndpointFedAuth | VT_BSTR | W | No | El token usado para la autenticación federada basada en notificaciones autenticación RDSTLS. |
| AllowAxToContainerEvents | VT_BOOL | W | No | Esta propiedad se agregó en Windows 11 22H2.
|
| ServerSupportsEdgeActions | VT_BOOL | R | N/A | Propiedad de solo lectura para determinar si la sesión remota tiene la funcionalidad RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411. |
| AppContainerID | VT_BSTR | W | No | El identificador de AppContainer pasado a IWorkspaceScriptable3::StartWorkspaceEx2 cuando se invoca IMsRdpClientNonScriptable8::StartWorkspaceExtension. Nota: El panel de control RemoteApp y Conexiones de escritorio ya no está en desarrollo activo. Puede modificarse o no estar disponible en versiones futuras de Windows. No se recomienda el uso de esta API. |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | No | Si True, se omite el movimiento del mouse generado mediante programación en la sesión remota. Más precisamente, no se aplica la PDU de actualización de posición del puntero. Consulte https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c. |
| RDmiDiagnosticsUrl | VT_BSTR | W | No | Esta propiedad ya no se admite. Está sujeto a eliminación en versiones futuras de Windows. No use esta propiedad. |
| EnableVailMonitorConfig | VT_BOOL | R/W | No | Si True, la información de supervisión extendida (por ejemplo, EDID) se envía a la sesión remota al sincronizar configuraciones de visualización. |
| Id. del área de trabajo | VT_BSTR | W | No | Identificador único de la conexión en Conexiones de Escritorio y RemoteApp a la que pertenece la sesión remota. |
| ShowConnectionInformation | VT_BOOL | W | Sí | Escribir True en esta propiedad muestra el cuadro de diálogo Información de conexión. |
| WslgSharedMemoryPath | VT_BSTR | W | No | Ruta de acceso al objeto de sesión de memoria para compartir el búfer de gráficos con la máquina virtual WSLg. |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | No | GUID asociado a la máquina virtual en ejecución que hospeda la aplicación remota. Escribir esta propiedad da como resultado un rendimiento mejorado para las aplicaciones remotas que se ejecutan en una máquina virtual local debido al uso compartido de memoria. |
| KDCProxyName | VT_BSTR | W | No | "Especifica el nombre de dominio completo de un servidor proxy del Centro de distribución de claves (KDC). El proxy de KDC permite al cliente RDP usar el protocolo de autenticación Kerberos cuando no puede acceder directamente a un KDC. Ejemplo del valor de propiedad: ""kdc.contoso.com"". Para obtener más información, consulte: Configurar un proxy del Centro de distribución de claves Kerberos, https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | No | Si True, los gestos en pantallas multitáctil no se enviarán al servidor remoto. De forma predeterminada, se establece en False. |
| HvSocketEnabled | VT_BOOL | W | No | Si True, el nombre del servidor remoto, si es un GUID, se interpreta como el campo VmId de la dirección del socket de Hyper-V donde se va a enviar el tráfico RDP. De forma predeterminada, se establece en False. Para obtener más información sobre las direcciones de Hyper-V socket, consulte Enlazar a un socket de Hyper-V. |
| MultipenRemotingSupported | VT_BOOL | W | No | Si True, la inyección simultánea de entrada de hasta cuatro dispositivos de lápiz se admite en la sesión remota. De forma predeterminada, se establece en False. |
| ShowGatewayInformation | VT_BOOL | W | Sí | Al escribir True en esta propiedad se muestra un cuadro de diálogo que muestra información sobre la puerta de enlace de Escritorio remoto. Windows 11 22H2 y versiones posteriores: esta propiedad ya no se admite y se ha reemplazado por la propiedad ShowConnectionInformation. |
| DisableAutoReconnectComponent | VT_BOOL | W | No | Si True, la conexión del servidor no se desconectará y se volverá a conectar automáticamente cuando se cambie la configuración de red. De forma predeterminada, se establece en False. |
| RedirectUsbDrive | VT_UI4 | R/W | No | Se introdujo en Windows 11 versión 24H2. Cuando no se establece o se establece en 0, la unidad usb usb se redirige como dirección de la unidad. Cuando se establece en 1, todas las unidades usb se redirigen como dispositivos USB automáticamente. Cuando se establece en 2, las unidades USB thumb se enumeran como dispositivos USB, los usuarios pueden optar por redirigirlas a través de la redirección USB desde la interfaz de usuario (cuadro de diálogo del dispositivo en la barra de conexión) o la entrada de archivo RDP "UsbDevicesToRedirect". |
| protocolos de seguridad permitidos | VT_BSTR | W | No | Se introdujo en Windows 11 versión 24H2. Esta propiedad se usa para restringir la lista de protocolos de seguridad que el cliente puede negociar. La lista real de protocolos negociados viene determinada por otras opciones de configuración y el escenario de conexión, y puede ser menor que la lista especificada en esta propiedad. El valor debe contener la lista de nombres de protocolo separados por ';' o el valor se puede establecer en "", lo que significa que se permiten todos los protocolos negociados normalmente. Los nombres de protocolo admitidos son: "TLS", "CredSSP", "RDSTLS" y "Autenticación de AAD de RDS" El valor predeterminado es "". |
| AllowRelativeMouseMode | VT_BOOL | R/W | No | Se introdujo en Windows 11 versión 24H2. Si es True, los movimientos del mouse se representan en relación con la posición actual del mouse. |
| RemoteAppMouseMoveInject | VT_BOOL | W | No | Se introdujo en Windows 11 versión 24H2. Al escribir True en esta propiedad, se fuerza la inyección de un mouse cuando el cursor sale de una ventana de RemoteApp. Esto está pensado para ser una solución alternativa para un error de información sobre herramientas. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo admitido |
Windows 8 |
| Servidor mínimo admitido |
Windows Server 2012 |
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting se define como 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting se define como A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting se define como 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings se define como 302D8188-0052-4807-806A-362B628F9AC5 |