IMsTscAxEvents::OnAutoReconnecting メソッド

クライアントがリモート デスクトップ セッション ホスト (RD セッション ホスト) サーバーとのセッションを自動的に再接続する処理中に呼び出されます。

構文

void OnAutoReconnecting(
  [in]  LONG                       disconnectReason,
  [in]  LONG                       attemptCount,
  [out] AutoReconnectContinueState *pArcContinueStatus
);

パラメーター

disconnectReason [in]

最後のセッション切断の理由を記述するコード。

attemptCount [in]

現在の自動再接続プロセスで試行された回数。 この数は、試行するたびに 1 ずつ増加します。

pArcContinueStatus [out]

自動再接続プロセスの状態を指定する、返されるコードへのポインター。 このコードをリセットして、現在の自動再接続プロセスの状態を変更できます。

このコードのリセットの詳細については、「解説」セクションを参照してください。

autoReconnectContinueAutomatic (0)

再接続プロセスが自動的に行われます。 これが既定値です。

autoReconnectContinueStop (1)

再接続プロセスが停止しました。

autoReconnectContinueManual (2)

再接続プロセスは手動で行われます。

戻り値

このメソッドは値を返しません。

解説

コントロールが RD セッション ホスト サーバーとの接続を再確立していることを示す通知を受け取るために、イベント シンクにこのメソッドを実装します。

pArcContinueStatus パラメーターの値を autoReconnectContinueAutomatic に設定して自動再接続プロセスの状態を変更すると、このメソッドは純粋にアドバイザリ モードで機能します。 コンテナーは、このイベントをリッスンして、自動再接続プロセスが進行していることを示す通知を受け取ることができます。 コントロールは、独自の内部タイミングと試行回数に基づいて接続の再確立を自動的に試行し続けます。 このメソッドは、コンテナーに通知するために、自動再接続の試行のたびに呼び出されます。

pArcContinueStatus パラメーターの値を autoReconnectContinueStop に設定して自動再接続プロセスの状態を変更すると、現在の自動再接続試行が終了し、切断通知がコンテナーに送信され、それ以上の自動再接続通知は発行されません。

pArcContinueStatus パラメーターの値を autoReconnectContinueManual に設定して自動再接続プロセスの状態を変更すると、コンテナーは Connect を呼び出して接続試行をトリガーするか、Disconnect を呼び出して自動再接続プロセスを手動で制御し、自動再接続プロセスを取り消します。 この値に設定すると、コントロールは自動再接続の試行を停止し、自動再接続試行をトリガーする Connect 呼び出しを行うコンテナーのポリシーになります。 これは、自動再接続プロセスの前にドロップされた RAS または VPN 接続の再起動など、コンテナーが自動再接続用にカスタマイズされた UI 動作を提供する場合に行われます。

リモート デスクトップ Web 接続の詳細については、「 リモート デスクトップ Web 接続の要件」を参照してください。

要件

関連項目

IMsTscAxEvents