IMsTscAx：：ConnectingText 屬性

指定控制項連接時，出現在控制項中置中的文字。

這是可讀寫的屬性。

Syntax

HRESULT put_ConnectingText(
  [in]  BSTR newVal
);

HRESULT get_ConnectingText(
  [out] BSTR *pConnectingText
);

新的顯示文字。

如果成功 ，則傳回S_OK 。

如果發生錯誤，則傳回非零 HRESULT 。

連接文字的範例是「連接到伺服器...」。

設定 ConnectingText 屬性是選擇性的。如果未設定，控制項會在建立連接之前顯示空白。

只有在控制項未處於線上狀態時，才可以設定這個屬性。如果在連接控制項時呼叫，它會傳回 E_FAIL 。您可以藉由回應 IMsTscAxEvents 中的線上活動或檢查 Connected 屬性來檢查控制項是否已連線。

get_ConnectingText屬性方法會配置pConnectingText參數所指向之緩衝區所需的記憶體。呼叫 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