États suspendus

Pendant une opération de connexion, il peut arriver que le serveur distant ne puisse pas continuer sans informations supplémentaires de la part de l’utilisateur local. À compter de Windows NT 3.5, la fonction RasDial prend en charge les états suspendus. Un état suspendu permet à l’Gestionnaire des connexions d’accès à distance de suspendre une opération de connexion afin que l’application cliente RAS puisse collecter des informations auprès de l’utilisateur.

Les états suspendus sont utiles dans les situations suivantes :

  • Lorsque l’utilisateur doit fournir un numéro de rappel .
  • Lorsque l’authentification de l’utilisateur échoue, l’utilisateur peut taper un nom d’utilisateur et un mot de passe différents.
  • Lorsque le mot de passe de l’utilisateur a expiré, il peut fournir un nouveau mot de passe.

Par défaut, la prise en charge de l’état suspendu est désactivée. Les clients RAS qui souhaitent prendre en charge les états suspendus doivent définir l’indicateur RDEOPTS_PausedStates dans la structure RASDIALEXTENSIONS passée en tant que paramètre à RasDial.

Lorsqu’un état suspendu se produit, le Gestionnaire des connexions d’accès à distance appelle le gestionnaire de notification du client. Si la prise en charge de l’état suspendu est désactivée, le message de notification indique une erreur et l’opération de connexion échoue. S’il est activé, le Gestionnaire des connexions suspend l’opération de connexion pour attendre la réponse du client RAS. Le client RAS peut reprendre l’opération de connexion par un deuxième appel RasDial ou l’arrêter en appelant la fonction RasHangUp .

Après avoir obtenu l’entrée de l’utilisateur, le client RAS redémarre l’opération de connexion en appelant à nouveau RasDial . Ce deuxième appel RasDial doit spécifier les informations suivantes :

  • Handle de connexion retourné par l’appel RasDial d’origine .
  • Le même gestionnaire de notification que l’appel RasDial d’origine .
  • Entrée de l’utilisateur dans les membres appropriés de la structure RASDIALPARAMS . Les autres membres de la structure RASDIALPARAMS doivent avoir les mêmes informations que celles spécifiées dans l’appel RasDial d’origine .

Le deuxième appel RasDial ne peut pas être effectué à partir du gestionnaire de notification.