Fonction de rappel RASADFUNCA (ras.h)

Article
03/01/2024

La fonction RASADFunc est une fonction de rappel définie par l’application qui est utilisée pour fournir une interface utilisateur personnalisée pour la connexion automatique.

Syntaxe

RASADFUNCA Rasadfunca;

BOOL Rasadfunca(
  LPSTR unnamedParam1,
  LPSTR unnamedParam2,
  LPRASADPARAMS unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

Paramètres

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

Valeur retournée

Si l’application effectue l’opération de numérotation, retourne TRUE. Utilisez le paramètre lpdwRetCode pour indiquer les résultats de l’opération de numérotation.

Si l’application n’effectue pas l’opération de numérotation, retournez FALSE. Dans ce cas, le système utilise l’interface utilisateur par défaut pour la numérotation.

Remarques

Lorsque le système démarre une opération AutoDial pour une entrée d’annuaire téléphonique avec un gestionnaire autoDial personnalisé, il appelle le RASADFunc spécifié. RASADFunc peut démarrer un thread pour effectuer l’opération de numérotation personnalisée. La fonction RASADFunc retourne TRUE pour indiquer qu’elle a pris en charge la numérotation, ou FALSE pour permettre au système d’effectuer la numérotation.

Si la fonction RASADFunc effectue l’opération de numérotation, elle présente sa propre interface utilisateur pour la numérotation et appelle la fonction RasDial pour effectuer la numérotation réelle. Le RASADFunc retourne ensuite TRUE pour indiquer qu’il a pris en charge la numérotation. Une fois l’opération de numérotation terminée, définissez la variable pointée vers par le paramètre lpdwRetCode pour indiquer la réussite ou l’échec.

La DLL autoDiale doit fournir à la fois une version RASADFUNCA (ANSI) et une version RASADFUNCW (Unicode) du gestionnaire RASADFunc . Pour activer un gestionnaire RASADFunc AutoDial pour une entrée d’annuaire téléphonique, utilisez la structure RASENTRY dans un appel à la fonction RasSetEntryProperties . Le membre szAutodialDll spécifie le nom de la DLL qui contient le gestionnaire, et le membre szAutodialFunc spécifie le nom exporté du gestionnaire. Le membre szAutodialFunc ne doit pas inclure le suffixe « A » ou « W ».

RASADFunc est un espace réservé pour le nom de fonction défini par la bibliothèque. Le type RASADFUNC est un pointeur vers une fonction RASADFunc .

Notes

L’en-tête ras.h définit RASADFUNC comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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