Fonction de rappel RASDIALFUNC (ras.h)

Article
03/01/2024

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.

Note Pour plus de commodité, RasHangUp peut être appelé à partir d’une fonction de rappel RasDialFunc . Toutefois, une grande partie du traitement du raccrochage se produit après le retour de la fonction de rappel RasDialFunc .

RemarqueRasDialFunc est un espace réservé pour le nom de fonction défini par l’application ou défini par la bibliothèque.

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