Método IRemoteDesktopClientSettings::SetRdpProperty (rdpappcontainerclient.h)

Establece el valor de una sola propiedad RDP con nombre.

Sintaxis

HRESULT SetRdpProperty(
  [in] BSTR    propertyName,
  [in] VARIANT value
);

Parámetros

[in] propertyName

Cadena que especifica el nombre de la propiedad.

Nota Estos valores de cadena no distinguen mayúsculas de minúsculas.

 

Los valores posibles son.

"sesión administrativa" (booleano)

Especifica si la sesión es una sesión administrativa. Puede ser uno de los siguientes valores.

false

La sesión no es una sesión administrativa.

True

La sesión es una sesión administrativa.

"permitir suavizado de fuentes" (booleano)

Especifica si se permite el suavizado de fuentes en la sesión remota. Puede ser uno de los siguientes valores.

false

No se permite el suavizado de fuentes.

True

Se permite suavizado de fuentes.

"dirección completa alternativa" (cadena)

Especifica un nombre alternativo o una dirección IP del equipo remoto al que desea conectarse.

"audiocapturemode" (booleano)

Especifica el modo de captura de entrada de audio. Puede ser uno de los siguientes valores.

false

No capture la entrada de audio.

True

Capture la entrada de audio.

"audiomode" (número)

Especifica dónde se reproducen los sonidos. Puede ser uno de los siguientes valores.

0

Reproducir sonidos en el equipo cliente.

1

Reproducir sonidos en el equipo host.

2

No reproduzca sonidos.

"nivel de autenticación" (número)

Especifica el nivel de autenticación de la sesión remota. Puede ser uno de los siguientes valores.

0

Ninguno.

1

Se necesita autenticación.

2

Autenticación negociable.

3

Autenticación no especificada.

"tipo de conexión" (número)

Especifica el tipo de conexión Este puede ser uno de los valores siguientes.

1

Módem

2

Banda ancha de baja velocidad

3

Satélite

4

Banda ancha de alta velocidad

5

WAN

6

LAN

7

Detección automática

"dirección del servidor de autenticación basada en cookies" (cadena)

Especifica la dirección del servidor de autenticación basado en cookies.

"desktopheight" (número)

Especifica el alto, en píxeles, del escritorio virtual.

"desktopwidth" (número)

Especifica el ancho, en píxeles, del escritorio virtual.

"deshabilitar el arrastre de ventana completa" (booleano)

Especifica si se muestra el contenido de la ventana mientras se arrastra está deshabilitado. Puede ser uno de los siguientes valores.

false

habilitado

True

Disabled

"disable menu anims" (Boolean)

Especifica si se deshabilitan las animaciones de menú que se muestran. Puede ser uno de los siguientes valores.

false

habilitado

True

Disabled

"deshabilitar temas" (booleano)

Especifica si los temas están deshabilitados. Puede ser uno de los siguientes valores.

false

habilitado

True

Disabled

"deshabilitar fondo de pantalla" (booleano)

Especifica si se muestran fondos de pantalla. Puede ser uno de los siguientes valores.

false

Se muestran fondos de pantalla.

True

Los fondos de pantalla no se muestran.

"domain" (String)

Especifica el dominio usado para conectarse a la sesión remota.

"enablecredsspsupport" (booleano)

Especifica si se debe usar la autenticación basada en CredSSP para la sesión remota. Puede ser uno de los siguientes valores.

false

No use la autenticación basada en CredSSP.

True

Use la autenticación basada en CredSSP.

"dirección completa" (cadena)

Especifica la dirección del equipo al que se está conectando.

"gatewaycredentialssource" (número)

Especifica el origen de las credenciales de la puerta de enlace de Escritorio remoto. Puede ser uno de los siguientes valores.

0

Pida al usuario sus credenciales y use la autenticación NTLM.

1

Use una tarjeta inteligente para las credenciales.

2

Use las credenciales del usuario que ha iniciado sesión actualmente.

3

Pida al usuario sus credenciales y use la autenticación básica.

4

El usuario seleccionará el origen de credenciales en el inicio de sesión.

5

Use la autenticación basada en cookies.

"gatewayhostname" (String)

Especifica el nombre del servidor de puerta de enlace de Escritorio remoto.

"gatewayprofileusagemethod" (número)

Especifica el uso del perfil de puerta de enlace de Escritorio remoto. Puede ser uno de los siguientes valores.

0

Use la configuración del perfil de puerta de enlace, si está presente.

1

Use la configuración de puerta de enlace explícita, incluso si existe un perfil de puerta de enlace.

"gatewayusagemethod" (número)

Especifica el uso de la puerta de enlace de Escritorio remoto. Puede ser uno de los siguientes valores.

0

No use un servidor de puerta de enlace de Escritorio remoto. La casilla Omitir servidor de puerta de enlace de Escritorio remoto para direcciones locales está desactivada.

1

Use la puerta de enlace de Escritorio remoto especificada por la propiedad "gatewayhostname".

2

Detecte automáticamente la configuración del servidor de puerta de enlace de Escritorio remoto.

3

Use la configuración predeterminada Configuración de uso de puerta de enlace de Escritorio remoto.

4

No use un servidor de puerta de enlace de Escritorio remoto. La casilla Omitir servidor de puerta de enlace de Escritorio remoto para direcciones locales está activada.

"mouse de alta resolución" (booleano)

Especifica el modo de resolución para la entrada del mouse. Puede ser uno de los siguientes valores.

false

La entrada del mouse se fusionará. Los datos del mouse se submuestrán y se enviarán según la frecuencia de muestreo predeterminada.

True

La entrada del mouse no se fusionará. Los datos del mouse se enviarán a resolución completa.

"loadbalanceinfo" (String)

Contiene la cookie de equilibrio de carga usada para elegir el mejor servidor para el equipo cliente.

"dirección de la página web de inicio de sesión" (cadena)

Especifica la dirección de la página web de inicio de sesión.

"dirección del servidor de autenticación previa" (cadena)

Especifica la dirección del servidor de autenticación previa.

"solicitar credenciales" (booleano)

Especifica si se le pedirá al usuario sus credenciales. Puede ser uno de los siguientes valores.

false

No se le pedirán credenciales al usuario.

True

Se le pedirá al usuario las credenciales.

"promptcredentialonce" (número)

Especifica si el uso compartido de credenciales para la puerta de enlace de Escritorio remoto está habilitado. Puede ser uno de los siguientes valores.

0

El uso compartido de credenciales está deshabilitado.

1

El uso compartido de credenciales está habilitado.

"redirectclipboard" (booleano)

Especifica si el Portapapeles del cliente se redirige a la sesión remota. Puede ser uno de los siguientes valores.

false

El Portapapeles no se redirige.

True

Se redirige el Portapapeles.

"redirectprinters" (booleano)

Especifica si las impresoras del cliente se redirigen a la sesión remota. Puede ser uno de los siguientes valores.

false

Las impresoras no se redirigen.

True

Se redirigen las impresoras.

"requerir autenticación previa" (número)

Especifica si se requiere autenticación previa. Puede ser uno de los siguientes valores.

0

No se requiere autenticación previa.

1

Se requiere autenticación previa.

"support url" (String)

Especifica la dirección URL de la que se va a obtener información de soporte técnico.

Boolean

"use redirection server name" (Boolean)

Especifica si se permite un servidor de redireccionamiento. Puede ser uno de los siguientes valores.

false

No se permite un servidor de redireccionamiento.

True

Se permite un servidor de redireccionamiento.

"username" (String)

Especifica el nombre de usuario usado para conectarse a la sesión remota.

"WinRTEncryptedPassword" (String)

Especifica una contraseña cifrada. Para establecer esta propiedad, debe realizar las siguientes acciones.

1. Convierta la contraseña de texto no cifrado en binario mediante el método ConvertStringToBinary en la clase CryptographicBuffer .
2. Establezca la propiedad WinRTPasswordEncoding mediante un valor equivalente para el parámetro de codificación que pasó al método ConvertStringToBinary en el paso 1.
3. Llame al método DataProtectionProvider(String) pasando "LOCAL=user" para la cadena de entrada.
4. Llame al método ProtectAsync para cifrar la cadena binaria que contiene la contraseña.
5. Convierta el objeto CryptographicBuffer devuelto por el método ProtectAsync en un valor codificado en Base64 mediante el método EncodeToBase64String .
6. Establezca esta propiedad (WinRTEncryptedPassword) con la cadena codificada en Base64 obtenida en el paso 5.

"WinRTPasswordEncoding" (número)

Especifica el tipo de codificación que se puede aplicar a una contraseña cifrada. Puede ser uno de los siguientes valores. El valor predeterminado es 1. Esta propiedad debe establecerse antes de establecer la propiedad WinRTEncryptedPassword .

0

UTF8

1

UTF16LE

2

UTF16BE

"Id. del área de trabajo" (cadena)

Especifica el identificador del área de trabajo Conexión a Escritorio y RemoteApp de la que se ha publicado este archivo RDP como parte de .

[in] value

Nuevo valor de propiedad.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	rdpappcontainerclient.h
Archivo DLL	MsTscAx.dll

Consulte también

IRemoteDesktopClientSettings