Le premier site francophone dédié au développement Pocket PC

Librairie de connexion RAS (partie 3)

RasConnect.dll (version 3)

RasConnect.dll est une librairie de connexion RAS, elle permet depuis eVB d'effectuer une connexion/déconnexion RAS.

La connexion se fait par la fonction Dial().
La déconnexion se fait par la fonction HangUp().
L'énumeration des connexion existantes se fait par la fonction EnumConnections().

Les nouvelles fonctions

Cette version 3 ajoute les fonctions suivantes :

* EnumEntries Enumeration des entrees existantes
* EnumDev Enumeration des péripheriques de communications
* CreateRasEntry Creation d'une entrée dans le Phone Book.

La création d'une entrée, pas si simple...

L'énumeration des entrées ainsi que des differents péripheriques de communications ne posent pas de problèmes majeurs car 2 APIs sont la pour faire le travail.

* RasEnumEntries()
* RasEnumDevices()

Par contre la création d'une entrée nous oblige à définir la configuration du périphérique de communication. Cette configuration se présente sous la forme d'une structure et est inscrite dans la base de registre sous le nom DevCfg.

Chaque connexion créé possède sa propre configuration. Elle se trouve dans :
HKEY_CURRENT_USER/Comm/RasBook/[MaConnexion]/DevCfg.

[MaConnexion] est le nom que vous avez donné a votre connexion. C'est une structure de 128 octets. Je n'ai pas identifie toute la structure.

La création de l'entrée se fait grâce a l'API RasSetEntryProperties() qui prend cette structure en paramètre. Les commentaires présents dans le code C devrait vous permettre de comprendre le fonctionnement de la creation. Pour la création de cette fonction, je me suis inspiré d'un article de Microsoft : Réf : Q163236 HOW TO Set Device Configuration for RAS PhoneBook Entry pour Windows NT4.

L'exemple eVB

L'exemple eVB est assez simple, un premier comboBox permet de lister les connexions existantes (si elles existent) dans la partie supérieure du formulaire.

La partie inférieure est utilisée pour la création d'une nouvelle entrée.

Dès que les paramètres sont entrés et que vous appuyez sur le bouton Créer, si aucune erreur n'est détectée, l'entrée est créée et apparait dans le comboBox supérieur.

C'est un exemple simple. Toutes les erreurs possibles ne sont pas gérées.

Conclusion

A noter que des améliorations sont toujours possibles. Vous êtes libre d'utiliser ce code àvotre convenance.
Je serai heureux de connaitre les modifications que vous pourriez y apporter.

Sources de la DLL et projet eVB d'exemple

Olivier Tome