Fonction de rappel RasCustomDialFn (ras.h)

Article
08/25/2023

[Cette fonction n’est pas disponible à partir de Windows Server 2008.

]

La fonction RasCustomDial est une fonction définie par l’application qui est exportée par une DLL de numérotation personnalisée tierce. Cette fonction permet aux fournisseurs tiers d’implémenter des routines de numérotation d’accès à distance personnalisées.

Syntaxe

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

Paramètres

hInstDll

Gérez vers le instance de la DLL de numérotation personnalisée qui a été chargée.

lpRasDialExtensions

Pointeur vers une structure RASDIALEXTENSIONS qui spécifie un ensemble de fonctionnalités étendues RasDial à activer. Définissez ce paramètre sur NULL s’il n’est pas nécessaire d’activer les extensions.

lpszPhonebook

Pointeur vers une chaîne terminée par null qui spécifie le chemin d’accès complet et le nom de fichier d’un fichier d’annuaire téléphonique (PBK). Si ce paramètre a la valeur NULL, la fonction utilise le fichier d’annuaire téléphonique par défaut actuel. Le fichier d’annuaire téléphonique par défaut est celui sélectionné par l’utilisateur dans la feuille de propriétés Préférences utilisateur de la boîte de dialogue Accès réseau à distance.

lpRasDialParams

Pointeur vers une structure RASDIALPARAMS qui spécifie les paramètres d’appel pour la connexion RAS.

L’appelant doit définir le membre dwSize de la structure RASDIALPARAMS sur sizeof (RASDIALPARAMS) pour identifier la version de la structure transmise.

dwNotifierType

Ce paramètre est identique au paramètre dwNotifierType pour la fonction RasDial . Pour plus d’informations , consultez la page de référence RasDial.

lpvNotifier

Ce paramètre est identique au paramètre lpvNotifier pour la fonction RasDial . Pour plus d’informations , consultez la page de référence RasDial.

lphRasConn

Pointeur vers une variable de type HRASCONN. Définissez la variable HRASCONN sur NULL avant d’appeler RasDial. Si RasDial réussit, il stocke un handle à la connexion RAS dans *lphRasConn.

dwFlags

Ce paramètre est réservé à une utilisation ultérieure.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS et un handle à la connexion RAS dans la variable pointée par le paramètre lphRasConn est retourné.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants ou une valeur provenant des codes d’erreur de routage et d’accès à distance ou de Winerror.h.

Valeur	Signification
ERROR_NOT_ENOUGH_MEMORY	La fonction n’a pas pu allouer suffisamment de mémoire pour terminer l’opération.

Notes

RAS appelle ce point d’entrée à partir de RasDial, si le membre szCustomDialDll de la structure RASENTRY pour l’entrée en cours de numérotation spécifie une DLL de numérotation personnalisée.

Si ce point d’entrée appelle RasDial, le paramètre lpRasDialExtensions ne doit pas être NULL, et le membre dwFlags de la structure RASDIALEXTENSIONS doit avoir l’indicateur RDEOPT_CustomDial défini.

Si la DLL de numérotation personnalisée ne prend pas en charge ce point d’entrée, RAS retourne ERROR_CANNOT_DO_CUSTOMDIAL à l’appelant de RasDial.

Spécifications


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