IMsTscAxEvents::OnAutoReconnecting 方法
當用戶端在自動重新連線到遠端桌面工作階段主機 (RD 工作階段主機) 伺服器時呼叫。
語法
void OnAutoReconnecting(
[in] LONG disconnectReason,
[in] LONG attemptCount,
[out] AutoReconnectContinueState *pArcContinueStatus
);
參數
-
disconnectReason [in]
-
描述最後一個會話中斷連線原因的程式碼。
-
attemptCount [in]
-
目前自動重新連線程式中已進行的嘗試次數。 每次嘗試時,此計數都會增加一個。
-
pArcContinueStatus [out]
-
傳回之程式碼的指標,指定自動重新連線程式的狀態。 您可以重設此程式碼,以變更目前自動重新連線程式的狀態。
如需重設此程式碼的詳細資訊,請參閱一節。
-
autoReconnectContinueAutomatic (0)
-
重新連線程式會自動發生。 這是預設值。
-
autoReconnectContinueStop (1)
-
重新連線程式已停止。
-
autoReconnectContinueManual (2)
-
重新連線程式正在手動發生。
傳回值
這個方法不會傳回值。
備註
在您的事件接收中實作這個方法,以接收控制項與 RD 工作階段主機伺服器重新建立連線的通知。
將 pArcContinueStatus 參數的值設定為 autoReconnectContinueAutomatic來變更自動重新連線程式的狀態時,這個方法會以純諮詢模式運作。 容器可以接聽此事件,以取得自動重新連線程式正在繼續的通知。 控制項會自動根據自己的內部時間和嘗試計數重新建立連線。 每次自動重新連線嘗試期間都會呼叫這個方法,以通知容器。
將 pArcContinueStatus 參數的值設定為 autoReconnectContinueStop來變更自動重新連線程式狀態時,將會終止目前的自動重新連線嘗試,將中斷連線通知傳送至容器,不會再發出任何自動重新連線通知。
注意
使用 EnableAutoReconnect 屬性來啟用或停用自動重新連線。
將 pArcContinueStatus 參數的值設定為 autoReconnectContinueManual來變更自動重新連線程式時,容器會呼叫 Connect 來觸發連線 嘗試或中斷 連線以取消自動重新連線程式,以手動控制自動重新連線程式。 設定為這個值之後,控制項會停止進行自動重新連線嘗試,並成為容器的原則,以呼叫 Connect 以觸發自動重新連線嘗試。 當容器提供自動重新連線的自訂 UI 行為時,就會完成此動作,例如在自動重新連線程式之前重新開機已卸載的 RAS 或 VPN 連線。
如需遠端桌面 Web 連線的詳細資訊,請參閱 遠端桌面 Web 連線的需求。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
類型程式庫 |
|
DLL |
|