IMsTscNonScriptable：：ClearTextPassword 屬性

以純文字格式設定遠端桌面 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
類型程式庫	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsTscNonScriptable定義為 c1e6743a-41c1-4a74-832a-0dd06c1c7a0e