IMsTscAx：：UserName 属性

指定用户名登录凭据。

此属性是可读写的。

语法

HRESULT put_UserName(
  [in]  BSTR newVal
);

HRESULT get_UserName(
  [out] BSTR *pUserName
);

新的用户名。

如果成功，则返回 S_OK 。

设置 UserName 属性是可选的。如果未指定，则用户可以在连接期间显示 Windows 登录对话框时提供用户名。

仅当控件未处于连接状态时，才能设置此属性。如果在连接控件时调用它，则返回 E_FAIL 。可以通过响应 IMsTscAxEvents 中的连接事件或检查 Connected 属性来检查控件是否已连接。

get_UserName 属性方法分配 pVersion 参数指向的缓冲区所需的内存。调用 C/C++ 应用程序必须通过调用 SysFreeString 函数来释放内存。 Visual Basic 和脚本客户端不需要此操作。

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

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
类型库	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsTscAx定义为 8C11EFAE-92C3-11D1-BC1E-00C04FA31489