Méthode IMsTscAxEvents::OnAutoReconnecting

Appelé lorsqu’un client est en cours de reconnexion automatique d’une session avec un serveur Hôte de session Bureau à distance (hôte de session Bureau à distance).

Syntaxe

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

Paramètres

disconnectReason [in]

Code décrivant la raison de la dernière déconnexion de session.

attemptCount [in]

Nombre de tentatives effectuées dans le processus de reconnexion automatique actuel. Ce nombre augmente d’un pour chaque tentative effectuée.

pArcContinueStatus [out]

Pointeur vers un code retourné spécifiant l’état du processus de reconnexion automatique. Ce code peut être réinitialisé pour modifier l’état du processus de reconnexion automatique actuel.

Pour plus d’informations sur la réinitialisation de ce code, reportez-vous à la section Remarques.

autoReconnectContinueAutomatic (0)

Le processus de reconnexion se produit automatiquement. Il s’agit de la valeur par défaut.

autoReconnectContinueStop (1)

Le processus de reconnexion a été arrêté.

autoReconnectContinueManual (2)

Le processus de reconnexion se produit manuellement.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Implémentez cette méthode dans votre récepteur d’événements pour recevoir une notification indiquant que le contrôle rétablit une connexion avec un serveur hôte de session Bureau à distance.

Lorsque l’état du processus de reconnexion automatique est modifié en définissant la valeur du paramètre pArcContinueStatus sur autoReconnectContinueAutomatic, cette méthode fonctionne en mode purement consultatif. Les conteneurs peuvent écouter cet événement pour les notifications indiquant que le processus de reconnexion automatique est en cours. Le contrôle continue automatiquement d’essayer de rétablir une connexion en fonction de son propre minutage interne et du nombre de tentatives. Cette méthode est appelée lors de chaque tentative de reconnexion automatique afin de notifier le conteneur.

Lorsque l’état du processus de reconnexion automatique est modifié en définissant la valeur du paramètre pArcContinueStatus sur autoReconnectContinueStop, la tentative de reconnexion automatique actuelle est arrêtée, une notification de déconnexion est envoyée au conteneur et aucune autre notification de reconnexion automatique n’est émise.

Notes

Utilisez la propriété EnableAutoReconnect pour activer ou désactiver la reconnexion automatique.

Lorsque l’état du processus de reconnexion automatique est modifié en définissant la valeur du paramètre pArcContinueStatus sur autoReconnectContinueManual, le conteneur contrôle manuellement le processus de reconnexion automatique en appelant Connect pour déclencher une tentative de connexion ou Disconnect pour annuler le processus de reconnexion automatique. Une fois cette valeur définie, le contrôle cesse d’effectuer des tentatives de reconnexion automatiques et il devient la stratégie du conteneur d’effectuer des appels Connect pour déclencher des tentatives de reconnexion automatiques. Cela est effectué lorsque le conteneur fournit un comportement d’interface utilisateur personnalisé pour la reconnexion automatique, comme le redémarrage d’une connexion RAS ou VPN supprimée avant le processus de reconnexion automatique.

Pour plus d’informations sur la connexion Web Bureau à distance, consultez Configuration requise pour la connexion Web Bureau à distance.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Bibliothèque de types	MsTscAx.dll
DLL	MsTscAx.dll

Voir aussi

IMsTscAxEvents