Método IMsTscAxEvents::OnAutoReconnecting
Chamado quando um cliente está no processo de reconectar automaticamente uma sessão com um servidor Host da Sessão da Área de Trabalho Remota (Host da Sessão rd).
Sintaxe
void OnAutoReconnecting(
[in] LONG disconnectReason,
[in] LONG attemptCount,
[out] AutoReconnectContinueState *pArcContinueStatus
);
Parâmetros
-
disconnectReason [in]
-
Código que descreve o motivo da última desconexão da 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.
Valor retornado
Esse método não retorna um valor.
Comentários
Implemente esse método no coletor de eventos para receber uma notificação de que o controle está restabelecendo uma conexão com um servidor host da 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 como 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 como autoReconnectContinueManual, o contêiner controlará manualmente o processo de reconexão automática chamando Conectar para disparar uma tentativa de conexão ou Desconectar para cancelar o processo de reconexão automática. Uma vez definido como esse valor, o controle deixará de fazer tentativas de reconexão automática e se tornará a política do contêiner para fazer chamadas connect para disparar tentativas de reconexão automática. Isso é feito quando o contêiner fornece um comportamento de interface do usuário personalizado 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 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 |
|
| DLL |
|