IRemoteDesktopClientSettings：：SetRdpProperty 方法 (rdpappcontainerclient.h)

設定單一具名 RDP 屬性的值。

語法

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

參數

[in] propertyName

指定屬性名稱的字串。

可能的值為 。

“系統管理會話” (布爾值)

指定工作階段是否為系統管理工作階段。 這可以是下列其中一個值。

false

會話不是系統管理會話。

對

會話是系統管理會話。

“allow font smoothing” (Boolean)

指定遠端工作階段是否允許字型平滑。 這可以是下列其中一個值。

false

不允許字型平滑。

對

允許字型平滑。

字串 (「替代完整位址」)

指定您要連線之遠端電腦的替代名稱或 IP 位址。

“audiocapturemode” (布爾值)

指定音訊輸入擷取模式。 這可以是下列其中一個值。

false

請勿擷取音訊輸入。

對

擷取音訊輸入。

“audiomode” (Number)

指定播放音效的位置。 這可以是下列其中一個值。

0

在用戶端電腦上播放音效。

1

在主電腦上播放音效。

2

不要播放音效。

“authentication level” (Number)

指定遠端工作階段的驗證層級。 這可以是下列其中一個值。

0

無。

1

需要驗證。

2

驗證功能。

3

未指定的驗證。

“connection type” (Number)

指定連接類型：這可以是下列其中一個值。

1

數據機

2

低速寬頻

3

衛星

4

高速寬頻

5

WAN

6

LAN

7

自動偵測

字串) 「Cookie 型驗證伺服器位址」 (

指定 Cookie 型驗證伺服器的位址。

“desktopheight” (Number)

指定虛擬桌面的高度，以像素為單位。

“desktopwidth” (Number)

指定虛擬桌面的寬度，以像素為單位。

“disable full window drag” (Boolean)

指定是否停用拖曳時顯示視窗內容。 這可以是下列其中一個值。

false

啟用

對

已停用

“disable menu anims” (Boolean)

指定是否停用顯示功能表動畫。 這可以是下列其中一個值。

false

啟用

對

已停用

“disable themes” (Boolean)

指定是否停用主題。 這可以是下列其中一個值。

false

啟用

對

已停用

“disable wallpaper” (布爾值)

指定是否顯示背景圖案。 這可以是下列其中一個值。

false

顯示背景圖案。

對

不會顯示背景圖案。

“domain” (String)

指定用來連線到遠程會話的網域。

“enablecredsspsupport” (布爾值)

指定是否針對遠端會話使用 CredSSP 型驗證。 這可以是下列其中一個值。

false

請勿使用 CredSSP 型驗證。

對

使用 CredSSP 型驗證。

“full address” (String)

指定所連接電腦的位址。

“gatewaycredentialssource” (Number)

指定遠端桌面閘道認證的來源。 這可以是下列其中一個值。

0

提示使用者輸入其認證，並使用NTLM驗證。

1

使用智慧卡進行認證。

2

使用目前登入用戶的認證。

3

提示使用者輸入其認證，並使用基本身份驗證。

4

使用者將會在登入時選取認證來源。

5

使用 Cookie 型驗證。

“gatewayhostname” (String)

指定遠端桌面閘道伺服器名稱。

“gatewayprofileusagemethod” (Number)

指定遠端桌面閘道設定檔使用量。 這可以是下列其中一個值。

0

如果有的話，請使用閘道設定檔設定。

1

使用明確的閘道設定，即使閘道配置檔存在也一樣。

“gatewayusagemethod” (Number)

指定遠端桌面閘道使用方式。 這可以是下列其中一個值。

0

請勿使用遠端桌面閘道伺服器。 已清除 [ 略過本機位址的 RD 閘道伺服器 ] 複選框。

1

使用 「gatewayhostname」 屬性所指定的遠端桌面閘道。

2

自動偵測遠端桌面閘道伺服器設定。

3

使用預設設定遠端桌面閘道使用方式設定。

4

請勿使用遠端桌面閘道伺服器。 已選取 [ 略過本機位址的 RD 閘道伺服器 ] 複選框。

“high resolution mouse” (Boolean)

指定滑鼠輸入的解析度模式。 這可以是下列其中一個值。

false

滑鼠輸入將會聯合。 滑鼠數據會根據預設取樣率進行子取樣和傳送。

對

不會聯合滑鼠輸入。 滑鼠數據將會以完整解析度傳送。

“loadbalanceinfo” (String)

包含用來選擇用戶端電腦最佳伺服器的負載平衡 Cookie。

字串) 「登入網址」 (

指定登入網頁的位址。

字串) 「預先驗證伺服器位址」 (

指定預先驗證伺服器的位址。

布爾值) 「提示輸入認證」 (

指定是否提示使用者輸入其認證。 這可以是下列其中一個值。

false

系統不會提示使用者輸入認證。

對

系統會提示使用者輸入認證。

“promptcredentialonce” (Number)

指定是否啟用遠端桌面閘道的認證共用。 這可以是下列其中一個值。

0

認證共用已停用。

1

已啟用認證共用。

“redirectclipboard” (布爾值)

指定用戶端的剪貼簿是否重新導向至遠端會話。 這可以是下列其中一個值。

false

剪貼簿不會重新導向。

對

剪貼簿會重新導向。

“redirectprinters” (布爾值)

指定客戶端的印表機是否重新導向至遠端工作階段。 這可以是下列其中一個值。

false

印表機不會重新導向。

對

列印機會重新導向。

「需要預先驗證」 (號碼)

指定是否需要預先驗證。 這可以是下列其中一個值。

0

不需要預先驗證。

1

需要預先驗證。

“support url” (String)

指定要從中取得支持資訊的 URL。

布林值

「使用重新導向伺服器名稱」 (布爾值)

指定是否允許重新導向伺服器。 這可以是下列其中一個值。

false

不允許重新導向伺服器。

對

允許重新導向伺服器。

“username” (String)

指定用來連線到遠端會話的用戶名稱。

“WinRTEncryptedPassword” (String)

指定加密的密碼。 若要設定此屬性，您必須執行下列動作。

1. 在 CryptographicBuffer 類別上使用 ConvertStringToBinary 方法，將純文本密碼轉換為二進位檔。
2. 針對您在步驟 1 中傳遞至 ConvertStringToBinary 方法的編碼參數，使用對等值來設定 WinRTPasswordEncoding 屬性。
3. 傳遞輸入字串的 「LOCAL=user」，呼叫 DataProtectionProvider (String) 方法。
4. 呼叫 ProtectAsync 方法來加密包含密碼的二進位字串。
5. 使用 EncodeToBase64String 方法，將 ProtectAsync 方法傳回的 CryptographicBuffer 物件轉換為 Base64 編碼值。
6. 使用步驟 5 中取得的 Base64 編碼字串， (WinRTEncryptedPassword) 設定此屬性。

“WinRTPasswordEncoding” (Number)

指定可套用至加密密碼的編碼類型。 這可以是下列其中一個值。 預設值為 1。 必須先設定此屬性，才能設定 WinRTEncryptedPassword 屬性。

0

UTF8

1

UTF16LE

2

UTF16BE

“Workspace Id” (String)

指定此 RDP 檔案已發行為其中一部分的 RemoteApp 和 Desktop 連線工作區識別碼。

[in] value

新的屬性值。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

另請參閱

IRemoteDesktopClientSettings