RASDIALFUNC2 fonction de rappel (ras.h)

Article
03/01/2024

Une fonction de rappel RasDialFunc2 est appelée par les appels de la fonction RasDial lorsqu’un changement d’état se produit pendant un processus de connexion d’accès à distance. Une fonction RasDialFunc2 est similaire à la fonction de rappel RasDialFunc1 , sauf qu’elle fournit des informations supplémentaires pour les connexions multilink.

Syntaxe

RASDIALFUNC2 Rasdialfunc2;

DWORD Rasdialfunc2(
  ULONG_PTR unnamedParam1,
  DWORD unnamedParam2,
  HRASCONN unnamedParam3,
  UINT unnamedParam4,
  tagRASCONNSTATE unnamedParam5,
  DWORD unnamedParam6,
  DWORD unnamedParam7
)
{...}

Paramètres

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

unnamedParam6

unnamedParam7

Valeur retournée

Si la fonction RasDialFunc2 retourne une valeur différente de zéro, RasDial continue d’envoyer des notifications de rappel.

Si la fonction RasDialFunc2 retourne zéro, RasDial cesse d’envoyer des notifications de rappel pour toutes les sous-entités.

Remarques

Une opération de connexion RasDial est suspendue lors d’un appel à une fonction de rappel RasDialFunc2 . Pour cette raison, l’implémentation de RasDialFunc2 retourne généralement 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 RasDialFunc2 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 RasDialFunc2 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 RasDialFunc2 . 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 RasDialFunc2 . Toutefois, une grande partie du traitement du blocage se produit après le retour de la fonction de rappel RasDialFunc2 .

RemarqueRasDialFunc2 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