局域网同步PPPoE之RAS

2007-11-25 13:52:02

近日我一直在开发一个可以在局域网内由一台服务端控制其他主机同步拨号的软件，环境是这样的，大家都使用WindowsXP OS，而且使用同一个宽带帐号，如此想都能上网有一种方法，即大家互相配合同时拨号（已经试验过）。

我的大概设计是这样的，采用c/s结构，由服务端向各客户端发送指令，客户端接收到指令后进行相应操作。如此，这个软件就有两大部分组成，即server和client对通信系统以及client的拨号系统。

拨号系统主要采用Win32 API中的RAS（remote access service）API实现，此前我接过一个实现VPN客户端的项目，由于当时缺乏对RAS的了解就夭折了。关于RAS对各种参考大家可以在MSDN的如下位置找到：

Win32和COM开发->Networking->Routing and Remote Access Service->SDK Documentation->Remote Access Service

在这里有所有API函数和各种结构的详细信息。

在不涉及Modem到拨号中，最重要的结构是RASDIALPARAMS，其中存放的是拨号连接的各种信息。结构如下：

typedef struct _RASDIALPARAMS {
DWORD dwSize
TCHAR szEntryName[RAS_MaxEntryName + 1];
TCHAR szPhoneNumber[RAS_MaxPhoneNumber + 1];
TCHAR szCallbackNumber[RAS_MaxCallbackNumber + 1];
TCHAR szUserName[UNLEN + 1];
TCHAR szPassword[PWLEN + 1];
TCHAR szDomain[DNLEN + 1] ;
#if (WINVER >= 0x401)
DWORD dwSubEntry;

ULONG_PTR dwCallbackId;
#endif
} RASDIALPARAMS;

其中dwSize必须初始化为sizeof(RASDIALPARAMS)，szEntryName就是PC上已经建立的将用来拨号的连接的名称，szPhoneNumber是拨号所用的电话号码，其优先级要高于szEntryName，也就是说，如果该项设置，拨号时将拨叫此号码，而不是szEntryName对应连接中设定的号码，在PPP拨号中该参数可以设置为NULL，szCallbackNumber为回拨号码，也可设置为NULL，szUserName和szPassword的作用很明显，szDomain在此情况下可设置为空，其余参数可不设置。

还有一个比较重要的结构，在介绍下一个函数前必须说明，RASCONN

typedef struct _RASCONN {
DWORD     dwSize;
HRASCONN hrasconn;
TCHAR     szEntryName[RAS_MaxEntryName + 1];

#if (WINVER >= 0x400)
TCHAR    szDeviceType[ RAS_MaxDeviceType + 1 ];
TCHAR    szDeviceName[ RAS_MaxDeviceName + 1 ];
#endif
#if (WINVER >= 0x401)
   TCHAR    szPhonebook [ MAX_PATH ];
   DWORD    dwSubEntry;
#endif
#if (WINVER >= 0x500)
   GUID     guidEntry;
#endif
#if (WINVER >= 0x501)
   DWORD     dwFlags;
   LUID      luid;
#endif
} RASCONN ;

在此只介绍前3个参数。dwSize仍然要初始化为sizeof(RASCONN)，hrasconn为某指定连接对应的句柄，szEntryName和前面介绍过的相同。

此处解释这么多并没有太大作用，我们只需要调用RasEnumConnections函数获得PC上拨号连接对应的szEntryName然后赋值给RASDIALPARAMS的szEntryName字段即可，当然还要设置用户名和密码。

下面介绍下RasEnumConnections函数

DWORD RasEnumConnections(
LPRASCONN lprasconn,
LPDWORD lpcb,
LPDWORD lpcConnections
);

该函数用来列举PC上的所有拨号连接。lprasconn指向一个RASCONN类型的数组，用来存放所得到的连接的信息，lpcb表明lprasconn指向的缓冲区的大小，lpcConnections表示所有连接的数目。

当然最重要的函数还是拨号函数RasDial

DWORD RasDial(
LPRASDIALEXTENSIONS lpRasDialExtensions,
LPCTSTR lpszPhonebook,
LPRASDIALPARAMS lpRasDialParams,
DWORD dwNotifierType,
LPVOID lpvNotifier,
LPHRASCONN lphRasConn

);

在此我们关注后面4个参数，前面两个可以设置为NULL。lpRasDialParams是一个指向RASDIALPARAMS结构的指针，其中就是拨号需要使用的连接信息。dwNotifierType有4个可选值：NULL表示采用同步拨号，其余3个都是在异步拨号时使用的，0表示以RasDialFunc函数作为回调函数，1表示以RasDialFunc1作为回调函数，2表示以RasDialFunc2作为回调函数，回调函数就是在RasDial返回各种状态时要调用的函数，需依照函数签名实现。lpvNotifier即和dwNotifierType对应的回调函数，最后lphRasConn指向连接成功后要返回的句柄。

还需要一个函数来返回PC上各个连接的状态RasGetConnectStatus

DWORD RasGetConnectStatus(
HRASCONN hrasconn ,
LPRASCONNSTATUS lprasconnstatus
);
该函数只有两个参数，hrasconn是指定连接的句柄，lprasconnstatus指向RASCONNSTATUS结构，用来存放连接状态。

最后的一个函数

DWORD RasHangUp(
HRASCONN hrasconn

);

待续...

本文出自 “天材之路” 博客，请务必保留此出处http://kittsoft.blog.51cto.com/37346/52128

上一篇封博篇　　下一篇局域网同步PPPoE之RAS(二)

类别：技术观 ┆ 技术圈() ┆ 阅读() ┆ 评论() ┆推送到技术圈 ┆返回首页

相关文章