IMsTscAx：：UserName 屬性

指定使用者名稱登入認證。

這是可讀寫的屬性。

Syntax

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