Partager via


États suspendus

Pendant une opération de connexion, il peut arriver que le serveur distant ne puisse pas continuer sans informations supplémentaires de l’utilisateur local. À compter de Windows NT 3.5, la fonction RasDial prend en charge les états suspendus. Un état suspendu permet au Gestionnaire de 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é, l’utilisateur 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 pour RasDial .

Lorsqu’un état suspendu se produit, le Gestionnaire de 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 de connexions interrompt l’opération de connexion pour attendre la réponse du client RAS. Le client RAS peut reprendre l’opération de connexion par une deuxième appel de 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 de RasDial doit spécifier les informations suivantes :

  • Handle de connexion retourné par l’appel deRasDial d’origine.
  • Le même gestionnaire de notification que l’appel deRasDial d’origine.
  • Entrée de l’utilisateur dans les membres appropriés de la structure RASDIALPARAMS. D’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.