Fonction de rappel RasCustomEntryDlgFn (rasdlg.h)
La fonction RasCustomEntryDlg 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 dialogues personnalisés pour la gestion des entrées d’annuaire téléphonique.
Syntaxe
RasCustomEntryDlgFn Rascustomentrydlgfn;
BOOL Rascustomentrydlgfn(
HINSTANCE hInstDll,
LPWSTR lpszPhonebook,
LPWSTR lpszEntry,
LPRASENTRYDLG lpInfo,
DWORD dwFlags
)
{...}
Paramètres
hInstDll
Gérez la instance de la DLL de numérotation personnalisée qui a été chargée.
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 à modifier, copier ou créer.
Si vous modifiez ou copiez une entrée, ce paramètre est le nom d’une entrée de carnet de téléphone existante. Si vous copiez une entrée, définissez l’indicateur RASEDFLAG_CloneEntry dans le membre dwFlags de la structure RASENTRYDLG .
Si vous créez une entrée, ce paramètre est un nouveau nom d’entrée par défaut que l’utilisateur peut modifier. Si ce paramètre a la valeur NULL, la fonction fournit un nom par défaut. Si vous créez une entrée, définissez l’indicateur RASEDFLAG_NewEntry dans le membre dwFlags de la structure RASENTRYDLG .
lpInfo
Pointeur vers une structure RASENTRYDLG 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( RASENTRYDLG). Utilisez le membre dwSize pour indiquer si vous créez, modifiez ou copiez une entrée. Si une erreur se produit, le membre dwError retourne un code d’erreur ; sinon, elle retourne zéro.
dwFlags
Réservé pour un usage futur.
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 RasEntryDlg, 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 la DLL de numérotation personnalisée ne prend pas en charge ce point d’entrée, RAS retourne ERROR_NO_CUSTOMENTRYDLG à l’appelant de RasEntryDlg.
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 |