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來變更自動重新連線程式時,容器會呼叫連線以手動控制自動重新連線程式,以觸發連線嘗試或中斷連線以取消自動重新連線程式。 設定為此值之後,控制項會停止進行自動重新連線嘗試,並成為容器的原則,以發出連線呼叫以觸發自動重新連線嘗試。 當容器提供自動重新連線的自訂 UI 行為,例如在自動重新連線程式之前重新開機已卸載的 RAS 或 VPN 連線時,就會完成此動作。

如需遠端桌面 Web 連線的詳細資訊,請參閱 遠端桌面 Web 連線的需求

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
類型程式庫
MsTscAx.dll
DLL
MsTscAx.dll

另請參閱

IMsTscAxEvents