RAS 函数

RAS协议:
 远程访问服务(RAS)是Windows 9X/NT/2000操作系统提供的系统服务器之一，通过电话线可以使单独的计算机接入网络，或通过两个RAS对拨使两个局域网互连，此项服务的功能可以使远程的计算机以较低的费用同网络连接，而且一旦建立了RAS连接，则可以使用其它的几乎所有的网络函数，对用户来说，实际上和通过网卡在基于网中进行数据传输是一样的。
拨号和连接管理：
 1拨号函数RasDial
  DWORD RasDial(
               LPRASDIALEXTENSIONS lpRasDialExtensions,
               LPCRSTR lpszPhonebook,
               LPRASDIALPARAMS lpRasDialParams,
               DWORD dwNotifierType,
               LPVOID lpvNotifier,
               LPHRASCONN lphRasConn);
参数说明:
(1)lpRasDialExtensions为RASDIALEXTENSIONS结构体变量
typedef struct tagRASDIALEXTENSIONS{
          DWORD dwSize;//必须设置为RASDIALEXTENSIONS结构体的长度(按字节)
          DWORD dwfOptions;//允许为使用RASDIAL扩展特性而设置为标志
          HWND  hwndParent;//不用，应该设置NULL字符
          ULONG_PTR reserved;//不用，应该设置0
#if(WINVER>=0x500)
          ULONG_PTR reserved1;保留 应该设置0
          RASEAPINFO RasEapInfo;//Windows 2000上，允许指定"扩展性身份验证协议"(EAP)信息
#endif
}RASDIALEXTENSIONS;

(2)lpRasDialParams
    lpRasDialParams为结果RASDIALPARAMS变量
 typedef struct _RASDIALPARAMS
{
   DWORD dwSize;//结构体长度(按字节).有了这个标志，RAS便可以对程序使用的操作系统平台版本进行内部判断。因为不同的操作系统，这个结构体是不一样的
   TCHAR szEntryName[RAS_MaxEntryName+1];//允许标志一个电话薄条目，该条目包含在RASDIAL函数的lpszPhonebook参数列出的电话薄文件内。该参数比较重要，因为电话薄条目能够使用户更好地指定RAS连接属性。如选定一个Modem或者一个分帧协议等，但是，为了使用RasDial而指定一个电话薄条目并不是非用不可，可以选择使用。如果该字段为空，RasDial就会选择系统上安装的第一个可以使用的Modem,并依据下一个参数szPhoneNumber来拨叫连接
   TCHAR szPhoneNumber[RAS_MaxPhoneNumber+1];//代表一个电话号码，优先于szEntryName指定的电话薄条目内包含的电话号码
   TCHAR szCallbackNumber[RAS_MaxCallbackNumber+1];//允许指定一个电话号码，RAS服务器可以给据这个号码回拨，如果RAS服务器允许有一个回拨号码，他就中断原来的连接，利用指定的回拨号码回拨
这个特性非常有用，因为服务器可以知道连接的用户来自何处。
   TCHAR szUserName[UNLEN+1];//标志RAS服务器上的用户进行身份验证时所用的登陆名
   TCHAR szPassword[PWLEN+1];//标志RAS服务器上的用户进行身份验证所用的密码
   TCHAR szDomain[DNLEN+1];//可选项，指定最初的电话薄字条目拨叫一个RAS多链路连接
#if(WINVER>=0x401)
   DWORD dwSubEntry;//标志用户帐号所在的Windows 2000或者NT区域
   ULONG_PTR dwCallbackId;//允许把一个应用程序定义的值投递到一个RasDidalFunc2回拨函数中
#endif
}RASDIALPARAMS;
(3)lpszPhonebook：识别到一个电话薄文件的路径
2 断开拨号函数RasHangUp:
  DWORD RasHangUp(HRASCONN hrasconn);//hrasconn正在连接的句柄，也就是在上一个函数中的最后一个参数hRasConn所得到的值
3 获取连接状态函数RasGetConnectStatus:
DWORD RasGetConnectStatus(HRASCONN hrasconn,LPRASCONNSTATUS Iprasconnstatus);
Iprasconnstatus为一个结构体RASCONNSTATUS，它取得当前连接状态
typedef struct _RASCONNSTATUS{
 DWORD         dwSize;//结构体大小
 RASCONNSTATE rasconnstate;//一种连接状态
 DWORD         dwError;//返回值不是0，就取得具体的错误代码
 TCHAR         szDeviceType[RAS_MaxDeviceType+1];//连接所用的设备类型
 TCHAR         szDeviceName[RAS_MaxDeviceName+1];//当前设备名称
}RASCONNSTATUS
RAS的活动连接状态 有很多
连接有3种活动状态:运行，暂停，中止
 运行:RasDial调用仍在进程当中，每一处运行状态活动都将提供进程状态分析
 暂停:表示RasDial需要更多的信息来建立连接，默认设置是取消暂停状态。在RASDIALEXTENSIONS结构中设置RDEOPT_PauseStates标志，便可以启用通知进程。当连接处于暂停状态时，可能有如下原因
  1 因为身份验证失败，用户需要提供新的登陆凭证
  2 密码过期，需要一个新密码
  3 用户密码需要提供一个回拨号码
中止: 表示RasDial拨号失败，或者RasHangUp函数关闭连接
 
 4枚举连接函数RasEnumConnections:列出所有活动的RAS连接
DWORD RasEnumConnections(LPRASCONN lprasconn,LPDWORD lpcb,LPDWORD lpcConnections);
 5子连接句柄RasGetSubEntryHandle:该函数允许为多连接中一个具体的字条目取得一个连接句柄，
 
 远程访问服务器利用这个投影信息来表示网络上的一个远程客户机，比如说，在一个分帧协议上建立一个连接的时候，这个连接采用的是IP协议，IP配置信息（如分配的ip地址）就会从RAS服务器到客户机之间建立起来。要想获得PPP(点对点)分帧协议上的协议投影信息，就可以使用管理连接函数中的第3个函数RasGetProjectionInfo
 6RasGetProjectionInfo:
  DWORD RasGetProjectionInfo(
                             HRASCONN hrasconn,//连接句柄
                             RASPROJECTION rasprojection,//枚举类型
                             LPVOID lpprojection,//取得一个数据结构该结构和rasprojection中指                                                 //定的枚举类型有关联
                             LPDWORD lpcb//
                              );//该函数返回时，变量Lpcb会得到包含获得投影信息所需要的缓冲区                                //长度
相关函数:
 1 RasEnumEntries: //Ras规定要获得所有连接，必须连续两次调用RasEnumEntries函数,第一次要获得需要的缓冲区的大小，然后申请该缓冲区；在第二次调用的时候才能够真正获得所有的连接。
 2 增加新的连接主要通过调用
   RasCreatePhonebookEntry(GetSafeHwnd(), sCurrentProvider);//新建拨号连接
 3 删除连接
  {
 //结构体
 typedef DWORD (WINAPI* RDE)
 (
  LPCTSTR lpszPhonebook,  // pointer to full path and filename of
  LPCTSTR lpszEntry    // pointer to an entry name to delete
 );
 // 载入动态库
 HINSTANCE hLib = LoadLibrary(_T("RASAPI32.DLL"));
 if (NULL == hLib) return;
 RDE rde = (RDE) GetProcAddress(hLib, "RasDeleteEntryA");
 if (rde != NULL)
 {
  rde(NULL, sCurrentProvider);
  QueryConnections();//查询连接状态
  QueryPhones(sCurrentProvider);查询目前的拨号情况
 }
 ::FreeLibrary(hLib);

  }
 4 编辑已有连接:
  RasEditPhonebookEntry(GetSafeHwnd(), NULL, sCurrentProvider);//编辑已有连接
 
 5 拨号:
   {
 RASDIALPARAMS rdParams;
 char  szBuf[256] = "";
 //--------------------------------------------------------------------------------

 ZeroMemory(&rdParams, sizeof(RASDIALPARAMS));
 rdParams.dwSize = sizeof(RASDIALPARAMS);
 //允许标志一个电话薄条目，该条目包含在RASDIAL函数的lpszPhonebook参数列出的电话薄文件内
 //该参数比较重要，因为电话薄条目能够使用户更好地指定RAS连接属性。如选定一个Modem或者一个分帧协议等，
 //但是，为了使用RasDial而指定一个电话薄条目并不是非用不可，可以选择使用。如果该字段为空，
 //RasDial就会选择系统上安装的第一个可以使用的Modem,并依据下一个参数szPhoneNumber来拨叫连接
 lstrcpy(rdParams.szEntryName, sCurrentProvider);//

 //rdParams.szPhoneNumber 代表一个电话号码，优先于szEntryName指定的电话薄条目内包含的电话号码
 int pd = atoi(theApp.GetIniString(gchMain, gchPulseDialing, "1"));
 if (1 == pd)
  lstrcpy(rdParams.szPhoneNumber, CString("P") + GetPhoneListSelection());
 else
  lstrcpy(rdParams.szPhoneNumber, GetPhoneListSelection());
 
 //--------------------------------------------------------------------------------
 CString un, pw;
 un = theApp.GetIniString(sCurrentProvider, "UserName", "");
 pw = theApp.GetPassword(TRUE);
 lstrcpy(rdParams.szUserName, un);//标志RAS服务器上的用户进行身份验证时所用的登陆名
 lstrcpy(rdParams.szPassword, pw);//标志RAS服务器上的用户进行身份验证所用的密码
 //--------------------------------------------------------------------------------

 //允许指定一个电话号码，RAS服务器可以给据这个号码回拨，如果RAS服务器允许有一个回拨号码，他就中断原来的连接，利用指定的回拨号码回拨
 //这个特性非常有用，因为服务器可以知道连接的用户来自何处
 rdParams.szCallbackNumber[0] = '*';
 rdParams.szDomain[0] = '*';//可选项，指定最初的电话薄字条目拨叫一个RAS多链路连接

 //--------------------------------------------------------------------------------
 //拨号
 DWORD dwRet;
 dwRet = RasDial(NULL,
              NULL,
     &rdParams,
     0L,
     (LPVOID)RasDialFunc,
     &hRasConn);
 //--------------------------------------------------------------------------------
 if (dwRet)
 {
  if (RasGetErrorString((UINT)dwRet, (LPSTR)szBuf, 256) != 0)
  m_LastCallText = szBuf;
 }
 return TRUE;
}
//回调函数
VOID WINAPI RasDialFunc(UINT unMsg, RASCONNSTATE rasconnstate, DWORD dwError)
{
 TRACE("RasDialFunc/n");
 if (unMsg != WM_RASDIALEVENT) TRACE("Strange event!/n");
 
 TRACE("RasDialFunc - exit/n");
}
 6 挂断拨号连接函数
 RasHangUp(hRasConn);//中心函数()RasGetConnectStatus(hRasConn, &rStatus);//获取连接状态函数