Gestionnaires de notification
Un appel RasDial asynchrone doit spécifier un gestionnaire de notification. Lors d’une opération de connexion asynchrone, le Gestionnaire des connexions d’accès à distance utilise le gestionnaire de notification pour informer le client RAS chaque fois que l’état de la connexion change ou qu’une erreur se produit.
Les actions effectuées par un gestionnaire de notifications 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 d’information.
- Gestion des états suspendus.
- Signalisation de l’application cliente RAS lorsque l’opération de connexion est 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 actuel de la connexion et les informations de code d’erreur. |
| RasDialFunc1 | Prototype de fonction de rappel qui reçoit le handle de connexion HRASCONN et des 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 quelle connexion change d’état. |
| RasDialFunc2 | Fonction de rappel similaire à RasDialFunc1. Toutefois, RasDialFunc2 est amélioré pour prendre en charge les connexions multilink. |
| Poignée 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 en charge aucune des fonctions de rappel. |
Le Gestionnaire des connexions d’accès à distance suspend l’opération de connexion jusqu’à ce que le gestionnaire de notification soit retourné. Pour cette raison, le gestionnaire doit retourner dès que 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, RasGetErrorString et RasHangUp) peuvent être appelées à partir d’un gestionnaire.