Метод IMsTscAxEvents::OnAutoReconnecting

Вызывается, когда клиент находится в процессе автоматического повторного подключения сеанса к серверу узла сеансов удаленных рабочих столов (узел сеансов удаленных рабочих столов).

Синтаксис

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

Параметры

disconnectReason [in]

Код, описывающий причину последнего отключения сеанса.

attemptCount [in]

Количество попыток, выполненных в текущем процессе автоматического повторного подключения. Это число увеличивается на один для каждой предпринятой попытки.

pArcContinueStatus [out]

Указатель на возвращенный код, указывающий состояние процесса автоматического повторного подключения. Этот код можно сбросить, чтобы изменить состояние текущего процесса автоматического повторного подключения.

Дополнительные сведения о сбросе этого кода см. в разделе Примечания.

autoReconnectContinueAutomatic (0)

Повторное подключение выполняется автоматически. Это значение по умолчанию.

autoReconnectContinueStop (1)

Процесс повторного подключения остановлен.

autoReconnectContinueManual (2)

Процесс повторного подключения выполняется вручную.

Возвращаемое значение

Этот метод не возвращает значение.

Комментарии

Реализуйте этот метод в приемнике событий, чтобы получать уведомление о том, что элемент управления повторно настроит подключение к серверу узла сеансов удаленных рабочих стола.

Если состояние процесса автоматического повторного подключения изменяется путем установки значения параметра pArcContinueStatusна autoReconnectContinueAutomatic, этот метод работает в режиме исключительно рекомендаций. Контейнеры могут прослушивать это событие для получения уведомлений о том, что процесс автоматического повторного подключения продолжается. Элемент управления будет автоматически пытаться восстановить подключение на основе собственного внутреннего времени и счетчика попыток. Этот метод вызывается при каждой попытке автоматического повторного подключения для уведомления контейнера.

При изменении состояния процесса автоматического повторного подключения путем установки параметра pArcContinueStatus значения autoReconnectContinueStop текущая попытка автоматического повторного подключения будет прервана, в контейнер будет отправлено уведомление об отключении, и дальнейшие уведомления об автоматическом повторном подключении не будут выдаваться.

Если состояние процесса автоматического повторного подключения изменяется путем установки значения параметра pArcContinueStatusв значение autoReconnectContinueManual, контейнер вручную управляет процессом автоматического повторного подключения, вызывая Connect для активации попытки подключения или Отключение , чтобы отменить процесс автоматического повторного подключения. После установки этого значения элемент управления перестанет выполнять попытки автоматического повторного подключения и станет политикой контейнера для выполнения вызовов Connect для активации попыток автоматического повторного подключения. Это делается, когда контейнер предоставляет настраиваемое поведение пользовательского интерфейса для автоматического повторного подключения, например перезапуск удаленного подключения RAS или VPN-подключения перед процессом автоматического повторного подключения.

Дополнительные сведения о веб-подключении к удаленному рабочему столу см. в разделе Требования к веб-подключению к удаленному рабочему столу.

Требования

См. также раздел

События IMsTscAxEvents