Propiedad IMsRdpExtendedSettings::Property

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 datos	Acceder	Se puede cambiar después de iniciar la conexión	Descripción
ConnectToChildSession	VT_BOOL	Leer/Escribir	Sí	Establecer esta propiedad en True hace que el control del cliente se conecte a la sesión secundaria en el equipo local en lugar de a un servidor remoto. Si esta propiedad está establecida 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	Leer/Escribir	No	Si el valor es True, las credenciales no se envían al servidor remoto.
EnableFrameBufferRedirection	VT_BOOL	Leer/Escribir	No	Si el valor es 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 el valor es True, se intenta la ayuda de hardware con la descodificación de gráficos.
IgnoreCursors	VT_BOOL	Solo escritura	No	Si el valor es True, los cursores que envía el servidor remoto se omiten.
ManualClipboardSyncEnabled	VT_BOOL	Leer/Escribir	Sí	Establecer esta propiedad en True significa que los Portapapeles locales y remotos no se mantendrán sincronizados automáticamente. En su lugar, debe usarse la interfaz IMsRdpClipboard para sincronizar los formatos del Portapapeles desde el Portapapeles local al Portapapeles remoto y del Portapapeles remoto al Portapapeles local.
ZoomLevel	*VT_UI4	Leer/Escribir	Sí	Implementa la característica Zoom mediante el control ActiveX RDP. La característica Zoom está disponible en el menú Sistema del RDP. La propiedad ZoomLevel no tiene ningún efecto en el modo RemoteApp y en el modo de pantalla completa. IMsRdpClientAdvancedSettings::SmartSizing y ZoomLevel son mutuamente excluyentes.
DisableSeamlessLanguageBar	VT_BOOL	R/W	No	Si el valor es True, esto hace que las conexiones RemoteApp vuelvan a la barra de idiomas 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 y emoticons.
HvSocketServiceId	VT_BSTR	W	No	Especifica el campo ServiceId de la dirección del socket Hyper-V donde se va a enviar el tráfico RDP.
DeviceScaleFactor	VT_UI4	R/W	No	Especifica el factor de escalado de dispositivo usado 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 id. 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 id. de dispositivo del dispositivo de captura de audio para redirigirlo. 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 RemoteApp. ITSRemoteProgram::RemoteProgramMode escribe en esta propiedad.
EnableRdsAadAuth	VT_BOOL	W	No	Si el valor es True, se usa la Seguridad de autenticación de AAD de RDS.
RDGIsKDCProxy	VT_BOOL	W	No	Si el valor es True, indica al cliente que use la puerta de enlace de Escritorio remoto (si se especifica) como servidor proxy de KDC.
UseURCP	VT_BOOL	R/W	No	Si el valor es True, esta propiedad habilita el Protocolo de control de frecuencia universal para las conexiones de Escritorio remoto basadas en UDP. Actualmente, está deshabilitada de forma predeterminada. Se recomienda habilitarla si el UDP está en uso.
DesktopScaleFactor	VT_UI4	R/W	No	Especifica el factor de escalado de dispositivo usado en la sesión remota. El valor debe estar comprendido entre 100 y 500 (porcentaje).
RedirectedAuthentication	VT_BOOL	W	No	Si el valor es True, se habilita Credential Guard remoto.
RestrictedLogon	VT_BOOL	W	No	Si el valor es True, el modo Administrador restringido está habilitado.
AudioPlaybackDevice	VT_BSTR	R/W	No	Especifica el id. de dispositivo del dispositivo de reproducción de audio en el equipo local. Las aplicaciones pueden usar el mensaje DRV_QUERYFUNCTIONINSTANCEID para determinar el id. de dispositivo del dispositivo de reproducción de audio para redirigirlo. "Como alternativa, se puede establecer en ""valor predeterminado"" 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	Una lista delimitada por comas o semicolumnas de id. de monitor para identificar los monitores seleccionados donde mostrar la sesión remota. El primer id. de la lista se tratará como el monitor principal en la sesión remota.
WslgModeEnabled	VT_BOOL	W	No	Si el valor es True, la sesión es una sesión WSLg. Se espera que se proporcionen las siguientes propiedades: WslgSharedMemoryPath HvSocketEnabled HvSocketServiceId Consulte la documentación de WSLg https://github.com/microsoft/wslg.
ShowSessionDiagnostics	VT_BOOL	W	Sí	Al escribir True en esta propiedad se 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á sujeta a cambios y a la eliminación.
PrintingProgressMode	VT_UI4	R/W	No	Posibles valores: 0: el cuadro de diálogo de progreso que se muestra al imprimir está deshabilitado 1: el cuadro de diálogo de progreso que se muestra al imprimir contiene información básica 2: el cuadro de diálogo de progreso que se muestra al imprimir contiene información detallada
CorrelationId	VT_BOOL	W	No	Invalida el valor devuelto por IMsRdpClientNonScriptable8::CorrelationId.
RequestUseNewOutputPresenter	VT_BOOL	W	No	Si el valor es 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 eliminación en futuras versiones de Windows, ya que el modo DirectX solo 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. Se eliminará en futuras versiones de Windows. No use esta propiedad.
EnableRemoteEdgeBar	VT_BOOL	R/W	No	Si el valor es True y la propiedad ServerSupportsEdgeActions es True, se muestran comandos adicionales en la barra de herramientas de conexión de la sesión remota.
TSGTransportIsUsed	VT_BOOL	R	N/A	Si el valor es 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 PDU de la solicitud de conexión X.224 del cliente.
EndpointFedAuth	VT_BSTR	W	No	El token usado para la autenticación RDSTLS federada basada en solicitudes.
AllowAxToContainerEvents	VT_BOOL	W	No	Esta propiedad se agregó en Windows 11 22H2. Si el valor es False (comportamiento predeterminado a partir de Windows 11 22H2), las combinaciones de teclas CTRL+ALT+TECLA DE DIRECCIÓN se envían a la sesión remota. Si el valor es True (comportamiento predeterminado antes de Windows 11 22H2), las combinaciones de teclas CTRL+ALT+TECLA DE DIRECCIÓN generan un evento IMsTscAxEvents::OnFocusReleased para la aplicación.
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 id. de AppContainer pasado a IWorkspaceScriptable3::StartWorkspaceEx2 cuando se invoca IMsRdpClientNonScriptable8::StartWorkspaceExtension. Nota: el panel de control Conexión de RemoteApp y 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 el valor es True, se omite el movimiento del mouse generado mediante programación en la sesión remota. Más concretamente, no se aplica la PDU de actualización de posición del puntero. Vea 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. Se eliminará en futuras versiones de Windows. No use esta propiedad.
EnableVailMonitorConfig	VT_BOOL	R/W	No	Si el valor es 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. de área de trabajo	VT_BSTR	W	No	Identificador único de la conexión en Conexión de RemoteApp y Escritorio 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 el valor es True, los gestos en pantallas multitáctiles no se enviarán al servidor remoto. De manera predeterminada, se establece en False.
HvSocketEnabled	VT_BOOL	W	No	Si el valor es 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 manera predeterminada, se establece en False. Para obtener más información sobre las direcciones del socket de Hyper-V, consulte Enlazar a un socket de Hyper-V.
MultipenRemotingSupported	VT_BOOL	W	No	Si el valor es True, la inyección simultánea de entrada de hasta cuatro dispositivos de lápiz se admite en la sesión remota. De manera 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.

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Biblioteca de tipos	MsTscAx.dll
Archivo DLL	MsTscAx.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

Consulte también

IMsRdpExtendedSettings