IMsTscNonScriptable::ClearTextPassword 属性

设置远程桌面ActiveX纯文本格式控制密码。

此属性是只写的。

语法

HRESULT put_ClearTextPassword(
  [in] BSTR newClearTextPass
);

属性值

用于连接的密码,以纯文本格式指定。

错误代码

如果成功,则返回 S_OK

备注

密码将传递到安全加密的 RDP 通信通道中的服务器。 设置纯文本密码后,无法以纯文本格式检索它。

仅当远程桌面ActiveX控件未处于连接状态时,才能设置 ClearTextPassword 属性。 如果控件已连接,则设置此属性会失败。 若要检查连接状态,请检索 IMsTscAx::Connected 属性。

还可以调用此方法在将纯文本密码转换为可移植编码的密码或二进制 (不可移植) 编码的密码之前设置纯文本密码。 但请注意,不应将编码的密码视为安全加密。

如果首先调用此方法以纯文本格式设置密码,则可以将密码转换为编码格式。

将纯文本密码转换为编码格式

  1. ClearTextPassword 属性中以纯文本格式设置密码。
  2. 若要检索二进制 (不可移植) 编码格式的密码,请检索 BinaryPassword 属性和 BinarySalt 属性。 编码的密码部分和盐部分都需要以二进制编码格式设置密码。
  3. 若要以可移植编码格式检索密码,请检索 PortablePassword 方法和 PortableSalt 属性。 这两个部分都需要以可移植编码格式设置密码。

执行上述三个步骤后,可以通过设置 BinaryPasswordBinarySalt 属性或 PortablePasswordPortableSalt 属性来设置编码格式的密码。 这两个部分是必需的。

若要启用自动登录,还必须设置 UserName 属性。 如果密码无法对用户进行身份验证,则会在服务器上显示“Windows登录”对话框,提示用户输入密码。

有关远程桌面 Web 连接的详细信息,请参阅 远程桌面 Web 连接的要求

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
类型库
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsTscNonScriptable定义为 c1e6743a-41c1-4a74-832a-0dd06c1c7a0e

另请参阅

IMsRdpClientNonScriptable

IMsRdpClientNonScriptable2

IMsRdpClientNonScriptable3

IMsRdpClientNonScriptable4

IMsRdpClientNonScriptable5

IMsTscNonScriptable