Método IMsTscAxEvents::OnAutoReconnecting

Chamado quando um cliente está no processo de reconectar automaticamente uma sessão com um servidor do Host de Sessão da Área de Trabalho Remota (Host de Sessão de Área de Trabalho Remota).

Sintaxe

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

Parâmetros

disconnectReason [in]

Código que descreve o motivo da desconexão da última sessão.

attemptCount [in]

Número de tentativas que foram feitas no processo de reconexão automática atual. Essa contagem aumenta em um para cada tentativa feita.

pArcContinueStatus [out]

Ponteiro para um código retornado que especifica o estado do processo de reconexão automática. Esse código pode ser redefinido para alterar o estado do processo de reconexão automática atual.

Para obter mais informações sobre como redefinir esse código, consulte a seção Comentários.

autoReconnectContinueAutomatic (0)

O processo de reconexão está ocorrendo automaticamente. Esse é o valor padrão.

autoReconnectContinueStop (1)

O processo de reconexão foi interrompido.

autoReconnectContinueManual (2)

O processo de reconexão está ocorrendo manualmente.

Retornar valor

Esse método não retorna um valor.

Comentários

Implemente esse método no coletor de eventos para receber a notificação de que o controle está restabelecendo uma conexão com um servidor host de sessão rd.

Quando o estado do processo de reconexão automática é alterado definindo o valor do parâmetro pArcContinueStatus como autoReconnectContinueAutomatic, esse método funciona em um modo puramente consultivo. Os contêineres podem escutar esse evento para notificações de que o processo de reconexão automática está em andamento. O controle continuará tentando restabelecer automaticamente uma conexão com base em seu próprio tempo interno e contagens de tentativas. Esse método é chamado durante cada tentativa de reconexão automática para notificar o contêiner.

Quando o estado do processo de reconexão automática for alterado definindo o valor do parâmetro pArcContinueStatus para autoReconnectContinueStop, a tentativa de reconexão automática atual será encerrada, uma notificação de desconexão será enviada ao contêiner e nenhuma outra notificação de reconexão automática será emitida.

Observação

Use a propriedade EnableAutoReconnect para habilitar ou desabilitar a reconexão automática.

Quando o estado do processo de reconexão automática é alterado definindo o valor do parâmetro pArcContinueStatus para autoReconnectContinueManual, o contêiner controlará manualmente o processo de reconexão automática chamando Conexão para disparar uma tentativa de conexão ou Desconectar para cancelar o processo de reconexão automática. Depois de definido como esse valor, o controle deixará de fazer tentativas de reconexão automática e se tornará a política do contêiner fazer Conexão chamadas para disparar tentativas de reconexão automática. Isso é feito quando o contêiner fornece um comportamento personalizado da interface do usuário para reconexão automática, como reiniciar uma conexão RAS ou VPN descartada antes do processo de reconexão automática.

Para obter mais informações sobre a Conexão Da Web da Área de Trabalho Remota, consulte Os requisitos para conexão da Web da Área de Trabalho Remota.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Biblioteca de tipos
MsTscAx.dll
DLL
MsTscAx.dll

Confira também

Imstscaxevents