Fonction de rappel RasCustomDialDlgFn (rasdlg.h)

Article
08/25/2023

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

]

La fonction RasCustomDialDlg 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 boîtes de dialogue de connexion RAS personnalisées.

Syntaxe

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

Paramètres

hInstDll

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

dwFlags

Ensemble d’indicateurs de bits qui spécifient les options RasCustomDialDlg .

Valeur	Signification
RCD_Logon	Si cet indicateur est défini sur un, la connexion a été établie à partir d’un contexte d’ouverture de session Windows. RasDial utilise ces informations pour obtenir les préférences utilisateur appropriées pour l’entrée de connexion. Si RasDial est appelé à partir de ce point d’entrée, le membre dwfOptions du paramètre lpRasDialExtension doit avoir l’indicateur RDEOPT_NoUser défini pour indiquer que la connexion a été composée à partir d’un contexte d’ouverture de session Windows.

Valeur

Signification

RCD_Logon

Si cet indicateur est défini sur un, la connexion a été établie à partir d’un contexte d’ouverture de session Windows. RasDial utilise ces informations pour obtenir les préférences utilisateur appropriées pour l’entrée de connexion. Si RasDial est appelé à partir de ce point d’entrée, le membre dwfOptions du paramètre lpRasDialExtension doit avoir l’indicateur RDEOPT_NoUser défini pour indiquer que la connexion a été composée à partir d’un contexte d’ouverture de session Windows.

Windows Server 2003 et Windows XP/2000 : Ce paramètre est réservé et ne doit pas être utilisé.

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 PBK (Phone-Book). Si ce paramètre a la valeur NULL, la fonction utilise le fichier d’annuaire 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 Mise en réseau à distance .

lpszEntry

Pointeur vers une chaîne terminée par null qui contient le nom de l’entrée de l’annuaire téléphonique à composer.

lpszPhoneNumber

Pointeur vers une chaîne terminée par un caractère Null qui contient un numéro de téléphone qui remplace les numéros stockés dans l’entrée du carnet de téléphone. Si ce paramètre a la valeur NULL, RasDialDlg utilise les numéros figurant dans l’entrée de l’annuaire téléphonique.

lpInfo

Pointeur vers une structure RASDIALDLG qui contient des paramètres d’entrée et de sortie supplémentaires. Lors de l’entrée, le membre dwSize de cette structure doit spécifier sizeof( RASDIALDLG). Si une erreur se produit, le membre dwError retourne un code d’erreur ; sinon, elle retourne zéro.

pvInfo

Réservé à un usage interne. Ce paramètre sera toujours NULL.

Valeur retournée

Si l’utilisateur crée, copie ou modifie une entrée d’annuaire téléphonique, la valeur de retour doit être TRUE. Sinon, la fonction doit retourner FALSE.

Si une erreur se produit, RasCustomEntryDlg doit définir le membre dwError de la structure RASENTRYDLG sur une valeur à partir des codes d’erreur de routage et d’accès à distance ou Winerror.h.

Remarques

RAS appelle ce point d’entrée à partir de RasDialDlg, 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 dwfOptions de la structure RASDIALEXTENSIONS doit avoir l’indicateur RDEOPT_CustomDial défini.

La boîte de dialogue de numérotation personnalisée doit prendre en charge WM_COMMAND messages où LOWORD(wParam) est égal à IDCANCEL.

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 RasDialDlg.

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	rasdlg.h