Método IMsTscAxEvents::OnAutoReconnecting

Se llama cuando un cliente está en proceso de volver a conectar automáticamente una sesión con un servidor host de sesión de Escritorio remoto (host de sesión de Escritorio remoto).

Sintaxis

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

Parámetros

disconnectReason [in]

Código que describe el motivo de la última desconexión de la sesión.

attemptCount [in]

Número de intentos realizados en el proceso de reconexión automática actual. Este recuento aumenta en uno por cada intento realizado.

pArcContinueStatus [out]

Puntero a un código devuelto que especifica el estado del proceso de reconexión automática. Este código se puede restablecer para cambiar el estado del proceso de reconexión automática actual.

Para obtener más información sobre cómo restablecer este código, consulte la sección Comentarios.

autoReconnectContinueAutomatic (0)

El proceso de reconexión se está produciendo automáticamente. Este es el valor predeterminado.

autoReconnectContinueStop (1)

Se ha detenido el proceso de reconexión.

autoReconnectContinueManual (2)

El proceso de reconexión se está produciendo manualmente.

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Implemente este método en el receptor de eventos para recibir una notificación de que el control está restableciendo una conexión con un servidor host de sesión de Escritorio remoto.

Cuando se cambia el estado del proceso de reconexión automática estableciendo el valor del parámetro pArcContinueStatus en autoReconnectContinueAutomatic, este método funciona en modo puramente de asesoramiento. Los contenedores pueden escuchar este evento para recibir notificaciones de que el proceso de reconexión automática continúa. El control seguirá intentando restablecer automáticamente una conexión en función de su propio tiempo interno e intentos. Se llama a este método durante cada intento de reconexión automática para notificar al contenedor.

Cuando se cambia el estado del proceso de reconexión automática estableciendo el valor del parámetro pArcContinueStatus en autoReconnectContinueStop, se finalizará el intento de reconexión automática actual, se enviará una notificación de desconexión al contenedor y no se emitirán más notificaciones de reconexión automáticas.

Nota

Utilice la propiedad EnableAutoReconnect para habilitar o deshabilitar la reconexión automática.

Cuando el estado del proceso de reconexión automática cambia estableciendo el valor del parámetro pArcContinueStatus en autoReconnectContinueManual, el contenedor controlará manualmente el proceso de reconexión automática llamando a Connect para desencadenar un intento de conexión o Desconectar para cancelar el proceso de reconexión automática. Una vez establecido en este valor, el control dejará de realizar intentos de reconexión automática y se convertirá en la directiva del contenedor para realizar llamadas connect para desencadenar intentos de reconexión automática. Esto se hace cuando el contenedor proporciona un comportamiento personalizado de la interfaz de usuario para la reconexión automática, como reiniciar una conexión RAS o VPN descartada antes del proceso de reconexión automática.

Para obtener más información sobre la conexión web de Escritorio remoto, consulte Requisitos para la conexión web de Escritorio remoto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Biblioteca de tipos	MsTscAx.dll
Archivo DLL	MsTscAx.dll

Consulte también

IMsTscAxEvents