以純文字格式設定遠端桌面 ActiveX 控制密碼。
此屬性是唯寫的。
Syntax
HRESULT put_ClearTextPassword(
[in] BSTR newClearTextPass
);
屬性值
用來連接的密碼，以純文字格式指定。
錯誤碼
如果成功 ，則傳回S_OK 。
備註
密碼會傳遞至安全加密 RDP 通道中的伺服器。 設定純文字密碼之後，就無法以純文字格式擷取。
只有當遠端桌面 ActiveX 控制項不是處於線上狀態時，才能設定 ClearTextPassword 屬性。 如果控制項已連接，則設定此屬性會失敗。 若要檢查線上狀態，請擷取 IMsTscAx：：Connected 屬性。
您也可以呼叫這個方法，在將它轉換成可攜式編碼密碼或二進位 (不可移植) 編碼密碼之前設定純文字密碼。 不過請注意，編碼的密碼不應視為安全加密。
如果您第一次呼叫此方法以純文字格式設定密碼，則可以將密碼轉換成編碼格式。
將純文字密碼轉換為編碼格式
- 在 ClearTextPassword 屬性中，以純文字格式設定密碼。
- 若要擷取二進位 (不可移植) 編碼格式的密碼，請擷取 BinaryPassword 屬性和 BinarySalt 屬性。 需要編碼的密碼部分和 salt 部分，才能以二進位編碼格式設定密碼。
- 若要擷取可攜式編碼格式的密碼，請擷取 PortablePassword 方法和 PortableSalt 屬性。 這兩個部分都需要以可攜式編碼格式設定密碼。
遵循上述三個步驟之後，您可以設定 BinaryPassword 和 BinarySalt 屬性，或 PortablePassword 和 PortableSalt 屬性，以編碼格式設定密碼。 這兩個部分都是必要的。
若要啟用自動登入，您也必須設定 UserName 和 Domain 屬性。 如果密碼無法驗證使用者，則會在伺服器顯示 [Windows 登入] 對話方塊，提示使用者輸入密碼。
如需遠端桌面 Web 連線的詳細資訊，請參閱 遠端桌面 Web 連線的需求。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 類型程式庫 |
|
| DLL |
|
| IID |
IID_IMsTscNonScriptable定義為 c1e6743a-41c1-4a74-832a-0dd06c1c7a0e |