RASDIALFUNC1 fonction de rappel (ras.h)

Article
03/01/2024

Une fonction RasDialFunc1 est appelée par la fonction RasDial lorsqu’un changement d’état se produit pendant un processus de connexion d’accès à distance. Une fonction RasDialFunc1 est comparable à une fonction RasDialFunc , mais elle est améliorée par l’ajout de deux paramètres : un handle à la connexion RAS et un code d’erreur étendu.

Syntaxe

RASDIALFUNC1 Rasdialfunc1;

void Rasdialfunc1(
  HRASCONN unnamedParam1,
  UINT unnamedParam2,
  tagRASCONNSTATE unnamedParam3,
  DWORD unnamedParam4,
  DWORD unnamedParam5
)
{...}

Paramètres

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

Valeur de retour

None

Remarques

Une opération de connexion RasDial est suspendue lors d’un appel à une fonction de rappel RasDialFunc1 . Pour cette raison, l’implémentation RasDialFunc1 retourne généralement aussi rapidement que possible. Il existe deux exceptions à cette règle. Les appareils asynchrones (lents) tels que les modems ont souvent des délais d’attente mesurés en secondes plutôt qu’en millisecondes ; Un retour lent d’une fonction RasDialFunc1 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 RasDialFunc1 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 RasDialFunc1 . 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.

Notez que, pour des raisons pratiques, RasHangUp peut être appelé à partir d’une fonction de rappel RasDialFunc1 . Toutefois, une grande partie du traitement de raccrochage se produit après le retour de la fonction de rappel RasDialFunc1 .

RasDialFunc1 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