通过

IRemoteDesktopClientSettings：：SetRdpProperty 方法 (rdpappcontainerclient.h)

  • 项目

设置单个命名 RDP 属性的值。

语法

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

参数

[in] propertyName

指定属性名称的字符串。

注意 这些字符串值不区分大小写。
 

可能的值是。

“管理会话” (布尔)

指定会话是否为管理会话。 这可以是以下值之一。

false

该会话不是管理会话。

True

会话是管理会话。

“允许字体平滑” (布尔)

指定是否允许在远程会话中使用字体平滑。 这可以是以下值之一。

false

不允许字体平滑。

True

允许字体平滑。

字符串) (“备用完整地址”

指定要连接到的远程计算机的备用名称或 IP 地址。

“audiocapturemode” (布尔)

指定音频输入捕获模式。 这可以是以下值之一。

false

不捕获音频输入。

True

捕获音频输入。

“audiomode” (数字)

指定声音的播放位置。 这可以是以下值之一。

0

在客户端计算机上播放声音。

1

在主计算机上播放声音。

2

不要播放声音。

“身份验证级别” (编号)

指定远程会话的身份验证级别。 这可以是以下值之一。

0

无。

1

要求验证。

2

身份验证可协商。

3

身份验证未指定。

“连接类型” (数字)

指定连接类型 这可以是以下值之一。

1

调制解调器

2

低速宽带

3

卫星

4

高速宽带

5

WAN

6

LAN

7

自动检测

指定基于 Cookie 的身份验证服务器的地址。

“desktopheight” (数字)

指定虚拟桌面的高度（以像素为单位）。

“desktopwidth” (数字)

指定虚拟桌面的宽度（以像素为单位）。

“禁用全屏拖动” (布尔)

指定是否禁用拖动时显示窗口内容。 这可以是以下值之一。

false

已启用

True

已禁用

布尔) (“禁用菜单 anims”

指定是否禁用显示菜单动画。 这可以是以下值之一。

false

已启用

True

已禁用

“禁用主题” (布尔)

指定是否禁用主题。 这可以是以下值之一。

false

已启用

True

已禁用

布尔) (“禁用壁纸”

指定是否显示壁纸。 这可以是以下值之一。

false

显示壁纸。

True

不显示壁纸。

“域” (字符串)

指定用于连接到远程会话的域。

“enablecredssupport” (布尔)

指定是否对远程会话使用基于 CredSSP 的身份验证。 这可以是以下值之一。

false

不要使用基于 CredSSP 的身份验证。

True

使用基于 CredSSP 的身份验证。

字符串) (“完整地址”

指定要连接到的计算机的地址。

“gatewaycredentialssource” (Number)

指定远程桌面网关凭据的源。 这可以是以下值之一。

0

提示用户输入其凭据并使用 NTLM 身份验证。

1

使用智能卡作为凭据。

2

使用当前登录用户的凭据。

3

提示用户输入其凭据并使用基本身份验证。

4

用户将在登录时选择凭据源。

5

使用基于 Cookie 的身份验证。

“gatewayhostname” (字符串)

指定远程桌面网关服务器名称。

“gatewayprofileusagemethod” (数字)

指定远程桌面网关配置文件的用法。 这可以是以下值之一。

0

使用网关配置文件设置（如果存在）。

1

使用显式网关设置，即使存在网关配置文件。

“gatewayusagemethod” (Number)

指定远程桌面网关的用法。 这可以是以下值之一。

0

请勿使用远程桌面网关服务器。 清除了“绕过本地地址的 RD 网关服务器”框检查。

1

使用由“gatewayhostname”属性指定的远程桌面网关。

2

自动检测远程桌面网关服务器设置。

3

使用默认设置远程桌面网关使用设置。

4

请勿使用远程桌面网关服务器。 选中“为本地地址绕过 RD 网关服务器”框检查。

“高分辨率鼠标” (布尔)

指定鼠标输入的解析模式。 这可以是以下值之一。

false

将合并鼠标输入。 将按默认采样率对鼠标数据进行子采样并发送。

True

不会合并鼠标输入。 鼠标数据将以全分辨率发送。

“loadbalanceinfo” (字符串)

包含用于为客户端计算机选择最佳服务器的负载均衡 Cookie。

“登录网页地址” (字符串)

指定登录网页的地址。

“预身份验证服务器地址” (字符串)

指定预身份验证服务器的地址。

“提示输入凭据” (布尔)

指定是否提示用户输入其凭据。 这可以是以下值之一。

false

系统不会提示用户输入凭据。

True

系统将提示用户输入凭据。

“promptcredentialonce” (数字)

指定是否为远程桌面网关启用凭据共享。 这可以是以下值之一。

0

凭据共享已禁用。

1

已启用凭据共享。

“redirectclipboard” (布尔)

指定是否将客户端的剪贴板重定向到远程会话。 这可以是以下值之一。

false

不会重定向剪贴板。

True

将重定向剪贴板。

“redirectprinters” (布尔)

指定客户端的打印机是否重定向到远程会话。 这可以是以下值之一。

false

不会重定向打印机。

True

将重定向打印机。

“需要预身份验证” (编号)

指定是否需要预身份验证。 这可以是以下值之一。

0

不需要预身份验证。

1

需要预身份验证。

“support url” (String)

指定要从中获取支持信息的 URL。

布尔值

“使用重定向服务器名称” (布尔)

指定是否允许重定向服务器。 这可以是以下值之一。

false

不允许重定向服务器。

True

允许重定向服务器。

“username” (String)

指定用于连接到远程会话的用户名。

“WinRTEncryptedPassword” (字符串)

指定加密的密码。 若要设置此属性，必须执行以下操作。

  1. 使用 CryptographicBuffer 类上的 ConvertStringToBinary 方法将明文密码转换为二进制。
  2. 通过使用在步骤 1 中传递给 ConvertStringToBinary 方法的编码参数的等效值来设置 WinRTPasswordEncoding 属性。
  3. 通过为输入字符串传递“LOCAL=user”，调用 DataProtectionProvider (String) 方法。
  4. 调用 ProtectAsync 方法来加密包含密码的二进制字符串。
  5. 使用 EncodeToBase64String 方法将 ProtectAsync 方法返回的 CryptographicBuffer 对象转换为 Base64 编码值。
  6. 使用步骤 5 中获取的 Base64 编码字符串 (WinRTEncryptedPassword) 设置此属性。

“WinRTPasswordEncoding” (数字)

指定可应用于加密密码的编码类型。 这可以是以下值之一。 默认值为 1。 在设置 WinRTEncryptedPassword 属性之前，必须设置此属性。

0

UTF8

1

UTF16LE

2

UTF16BE

“工作区 ID” (字符串)

指定此 RDP 文件已发布的 RemoteApp 和桌面连接工作区的标识符。

[in] value

新的属性值。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 rdpappcontainerclient.h
DLL MsTscAx.dll

另请参阅

IRemoteDesktopClientSettings