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

Librairie de connexion RAS (partie 2)

RasConnect.dll (version 2)

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().

Etablissement de la connexion

Long = Dial(ByVal sEntryName as String, ByRef hConn as Long)

[in] sEntryName : le nom de la connexion a executer. ATTENTION CASE SENSITIVE
[in, out] hConn : contiendra le handle de la connexion

code retour : 0 = succès, ou le code erreur rencontrée.

Fermeture de la connexion

Long = HangUp(ByRef hConn as Long)

[in, out] hConn : le handle retourné par la fonction Dial(). Une fois la connexion fermée, hConn = 0.
Remarque : si une erreur se produit lors de la fermeture, hConn n'est pas initialisé a 0.

code retour : 0 = succès, ou le code erreur rencontrée.

Note : Si hConn = 0 lors de l'appel, un message d'information est affiché.

Enumérer les connexions existantes

Sous PocketPC, il n'est pas possible d'avoir plus d'une connexion àla fois.

Long = EnumConnections()

Cette fonction ne prend pas de paramètres. Elle se contente de retourner le handle de la connexion active ou 0 si aucune connexion.

Le projet eVB

Le projet eVB permet de tester la librairie. Il se compose d'un formulaire et de 2 boutons :
- Connecter
- Deconnecter

Lors du chargement du formulaire, la fonction EnumConnections() se charge de détecter la présence d'une connexion. La variable g_hConn contiendra le handle retourné par la fonction ou 0.

Si une connexion existe, seul le bouton déconnecter est actif, il permet de supprimer la connexion active.
Autrement, le programme tentera d'établir la connexion donnée en paramètre à la fonction Dial().

J'utilise la connexion par defaut d'ActiveSync afin de montrer le processus de connexion. Tout le monde ne possède pas un GSM avec un abonnement DATA.

Voila, la prochaine fois j'aborderai comment lister toutes les connexions RAS existantes dans un comboBox afin d'exécuter celle de son choix. Enfin pour terminer comment créer une entrée RAS (phone book entry) directement depuis eVB.

Sources de la DLL et projet eVB d'exemple

Olivier Tome