Gestionnaires de notification
Un appel derasDial asynchronedoit spécifier un gestionnaire de notification. Pendant une opération de connexion asynchrone, le Gestionnaire de connexions d’accès à distance utilise le gestionnaire de notifications pour informer le client RAS chaque fois que l’état de connexion change ou qu’une erreur se produit.
Les actions effectuées par un gestionnaire de notification peuvent être divisées en catégories suivantes :
- Gestion des erreurs.
- Fournir des commentaires à l’utilisateur à mesure que l’opération de connexion passe par les différents états de connexion. Consultez notifications informationnelles.
- Gestion des états suspendus .
- Signalisation de l’application cliente RAS lorsque l’opération de connexion a été terminée. Consultez notifications d’achèvement.
Il existe trois types de gestionnaires de notification, chacun recevant les mêmes informations de base : l’état de connexion actuel et un code d’erreur différent de zéro uniquement si une erreur s’est produite.
Valeur | Définition |
---|---|
RasDialFunc | Prototype de fonction de rappel qui reçoit uniquement l’état de connexion actuel et les informations de code d’erreur. |
RasDialFunc1 | Prototype de fonction de rappel qui reçoit le HRASCONN handle de connexion et les informations d’erreur étendues en plus des informations de base. Le paramètre de handle de connexion rend RasDialFunc1 utile pour les applications clientes qui prennent en charge plusieurs opérations de connexion simultanées. Cela permet au client de spécifier la même fonction de rappel pour toutes les opérations et permet à la fonction de rappel de déterminer quels états changent la connexion. |
RasDialFunc2 | Fonction de rappel similaire à RasDialFunc1. Toutefois, RasDialFunc2 est amélioré pour prendre en charge les connexions multilink. |
Handle de fenêtre | Handle de fenêtre auquel RAS envoie WM_RASDIALEVENT messages contenant l’état de connexion actuel et les informations de code d’erreur. Utilisez cette méthode si votre code source doit être compatible avec Windows 16 bits, car Windows 16 bits ne prend pas en charge l’une des fonctions de rappel. |
Le Gestionnaire de connexions d’accès à distance interrompt l’opération de connexion jusqu’à ce que le gestionnaire de notification retourne. Pour cette raison, le gestionnaire doit retourner le plus tôt possible, sauf si une erreur s’est produite.
La fonction RasDial ne doit pas être appelée à partir d’un gestionnaire de notification. Les autres fonctions d’accès à distance (RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorStringet RasHangUp) peuvent être appelées à partir d’un gestionnaire.