Fonction de rappel RASADFUNCA (ras.h)

Article
11/20/2024

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

Syntaxe

RASADFUNCA Rasadfunca;

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

Paramètres

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

Valeur de retour

Si l’application effectue l’opération de numérotation, retournez 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 de carnet téléphonique avec un gestionnaire AutoDial personnalisé, il appelle le RASADFunc spécifié. Le 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 le contrôle de la numérotation, ou FAUX 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 le contrôle de la numérotation. Une fois l’opération de numérotation terminée, définissez la variable pointée par le paramètre lpdwRetCode pour indiquer la réussite ou l’échec.

La DLL autoDial doit fournir à la fois une RASADFUNCA (ANSI) et une version RASADFUNCW (Unicode) du gestionnaire RASADFunc . Pour activer un gestionnaire d'RASADFunc AutoDial pour une entrée de carnet 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 szAutodialFunc membre spécifie le nom exporté du gestionnaire. Le szAutodialFunc membre ne doit pas inclure le suffixe « A » ou « W ».

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

Note

L’en-tête ras.h définit RASADFUNC comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	ras.h

Voir aussi

RASENTRY

RasDial

RasSetEntryProperties

Vue d’ensemble service d’accès à distance (RAS)

fonctions de service d’accès à distance

Partager via