Fonction RasSecurityDialogEnd (rasshost.h)

  • Article

La fonction RasSecurityDialogEnd est un point d’entrée DE DLL de sécurité RAS tiers que le serveur RAS appelle pour mettre fin à une transaction d’authentification.

Note Windows Server 2008, Windows Server 2003, Windows 2000 Server et Windows NT Server 4.0 fournissent actuellement une prise en charge de l’hôte de sécurité RAS pour les appareils série uniquement. D’autres types de connexions, tels que les connexions ISDN (Integrated Services Digital Network) ou VPN (Virtual Private Network), ne sont pas prises en charge.
 

Syntaxe

DWORD RasSecurityDialogEnd(
  [in] HPORT hPort
);

Paramètres

[in] hPort

Spécifie le handle de port que le serveur RAS a passé à la DLL de sécurité dans l’appel RasSecurityDialogBegin pour cette transaction d’authentification.

Valeur retournée

Si la DLL de sécurité retourne NO_ERROR, le serveur RAS n’arrête pas la transaction d’authentification. Dans ce cas, la DLL de sécurité doit ultérieurement appeler la fonction RasSecurityDialogComplete lorsqu’elle est prête à se terminer.

Si la DLL de sécurité retourne un code d’erreur différent de zéro, le serveur RAS met fin à la transaction d’authentification. Dans ce cas, la DLL de sécurité n’a pas besoin d’effectuer un autre appel RasSecurityDialogComplete . Retourne un code d’erreur défini dans Winerror.h ou Raserror.h, tel que ERROR_PORT_DISCONNECTED.

Remarques

Lorsqu’une DLL de sécurité a terminé l’authentification de l’utilisateur distant, elle appelle la fonction RasSecurityDialogComplete . Le serveur RAS effectue ensuite une séquence de nettoyage qui inclut un appel à la fonction RasSecurityDialogEnd de la DLL. Cela permet à la DLL de sécurité d’effectuer tout nettoyage nécessaire. Pour mettre fin à la transaction d’authentification, RasSecurityDialogEnd doit retourner un code d’erreur différent de zéro.

Le serveur RAS peut également appeler RasSecurityDialogEnd s’il doit arrêter anormalement la transaction d’authentification avant que la DLL de sécurité appelle RasSecurityDialogComplete. Dans ce cas, la DLL de sécurité doit arrêter le thread de travail associé au handle de port hPort et effectuer tout autre nettoyage nécessaire. Si RasSecurityDialogEnd retourne une valeur différente de zéro, la DLL de sécurité n’a pas besoin d’appeler RasSecurityDialogComplete.

Pour l’arrêt normal et anormal, la fonction RasSecurityDialogEnd retourne NO_ERROR pour retarder l’arrêt. Dans ce cas, il doit appeler ultérieurement RasSecurityDialogComplete lorsqu’il est prêt à se terminer.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête rasshost.h

Voir aussi

Fonctions d’administration du serveur RAS

RasSecurityDialogBegin

RasSecurityDialogComplete

Vue d’ensemble du service d’accès à distance (RAS)