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
類型程式庫	MsTscAx.dll
DLL	MsTscAx.dll

另請參閱

IMsTscAxEvents