Fonction de rappel RASDIALFUNC (ras.h)
La fonction de rappel RasDialFunc est appelée par la fonction RasDial lorsqu’un changement d’état se produit pendant un processus de connexion RAS.
Syntaxe
RASDIALFUNC Rasdialfunc;
void Rasdialfunc(
UINT unnamedParam1,
tagRASCONNSTATE unnamedParam2,
DWORD unnamedParam3
)
{...}
Paramètres
unnamedParam1
unnamedParam2
unnamedParam3
Valeur de retour
None
Remarques
Une opération de connexion RasDial est suspendue pendant un appel à une fonction de rappel RasDialFunc . Pour cette raison, l’implémentation de RasDialFunc doit généralement revenir le plus rapidement possible. Il existe deux exceptions à cette règle. Les appareils asynchrones (lents), tels que les modems, ont souvent des délais d’expiration mesurés en secondes plutôt qu’en millisecondes ; un retour lent d’une fonction RasDialFunc n’est généralement pas un problème. L’exigence de retour d’invite ne s’applique pas non plus lorsque dwError est différent de zéro, ce qui indique qu’une erreur s’est produite. Par exemple, il est sûr d’afficher une boîte de dialogue d’erreur et d’attendre l’entrée de l’utilisateur.
L’implémentation de RasDialFunc ne doit pas dépendre de l’ordre ou de l’occurrence d’états de connexion RASCONNSTATE particuliers, car cela peut varier d’une plateforme à l’autre.
N’appelez pas la fonction RasDial à partir d’une fonction de rappel RasDialFunc . Appelez les fonctions RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString et RasHangUp à partir de la fonction de rappel. Par exemple, l’appel de RasGetConnectStatus à partir d’une fonction de rappel serait utile pour déterminer le nom et le type de l’appareil de connexion.
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 | ras.h |