码迷，mamicode.com
首页 > 其他好文 > 详细

RAS函数详解

时间：2014-12-29 13:48:08      阅读：387      评论：0      收藏：0      [点我收藏+]

标签：

1.什么叫RAS？
答:微软的所有Wi n d o w s平台中都有RAS客户机,它允许我们将自己的计算机与另一个地方
的远程计算机（其特色是一个远程访问服务器组件）相连，一般情况下，  RAS客户机利用连
接了电话线的一个调制解调器，通过拨号的方式呼叫远程计算机。因此，有时， RAS客户机
也称作“拨号联网（DUN）客户机”。服务器这方面，必须有一项等候DUN连接的服务，
RAS客户机和服务器之间的连接建立之后，网络协议堆栈（与所用的分帧协议有关）就
通过这个RAS连接，与远程计算机通信，就象通过LAN连接的一样。当然，如今，许多调制
解调器的数据通信速率明显比直接的LAN连接慢。RAS连接通过电话簿条目中可用的选项，经过验证后，RAS便可自
动进入一台机器，登录到一个域。
2.RAS错误打印？
Raserror.h列举了相当多预先定义的错误代码。这个文件中，大家将注意到一个错误说明
字串，这个字串和RAS中所用的各错误代码关联在一起RasGetErrorString
3.平台兼容？
RAS函数所用的有些数据结构中，根据
WINVER定义的值，分别使用或不用额外的数据字段。
所以一定要定义当前的WINVER，不然就失败返回632
直接去targetver.h中看，比如XP:
/ 没有#define WINVER 0x0501 
就直接加上

[cpp] view plaincopy
  1. #ifndef WINVER  
  2. #define WINVER 0x0501  
  3. #endif   

 

4.具体函数介绍:
(1)

[cpp] view plaincopy
  1. DWORD RasDial(  
  2.   __in          LPRASDIALEXTENSIONS lpRasDialExtensions,  
  3.   __in          LPCTSTR lpszPhonebook,  
  4.   __in          LPRASDIALPARAMS lpRasDialParams,  
  5.   __in          DWORD dwNotifierType,  
  6.   __in          LPVOID lpvNotifier,  
  7.   __in          LPHRASCONN lphRasConn  
  8. );  

 

lpRasDialExtensions：参数是一个可选指针，指向一个RASDIALEXTENSIONS结构，有了
这个结构，你的应用程序便可使用RasDial函数的扩展特性了， 可忽略，设为NULL
pszPhonebook：用于识别到一个电话簿文件的路径。设为NULL，表示使用当前默认电话簿文件
lpRasDialParams：定义了拨号和用户身份验证参数
dwNotifierType， lpvNotifier：可同步调用还是异步调用?
lphRasConn:

下面继续对此函数的内部结构解析:
第一个参数lpRasDialExtensions对应的结构体:

[cpp] view plaincopy
  1. typedef struct tagRASDIALEXTENSIONS {   
  2.   DWORD     dwSize;  
  3.   DWORD     dwfOptions;  
  4.   HWND      hwndParent;  
  5.   ULONG_PTR reserved;  
  6. #if (WINVER >= 0x500)  
  7.   ULONG_PTR reserved1;  
  8.   RASEAPINFO RasEapInfo;  
  9. #endif  
  10. } RASDIALEXTENSIONS  

 

dwSize：必须设为RASDIALEXTENSIONS结构的长度（按字节算）。
dwfOptions:允许你为使用RasDial扩展特性而设置位标志:如下：
                      RDEOPT_UsePrefixSuffix：令RasDial使用与指定拨号设备关联的前缀和后缀
                      RDEOPT_PausedStates：允许RasDial进入暂停操作状态，从而用户就可以重试登录、改变密码和设置回拨号码
                      RDEOPT_IgnoreModemSpeaker:令RasDial忽略RAS电话簿中的Modem喇叭设置
                      RDEOPT_SetModemSpeaker:如果设置了  RDEOPT_IgnoreModemSpeaker标志，那么利用这个标志，可以打开Modem喇叭
                      RDEOPT_IgnoreSoftwareCompression:令RasDial忽略软件压缩设置
                      RDEOPT_SetSoftwareCompression:在设置了 RDEOPT_IgnoreSoftwareCompression标志的前提下，再用这个标志，便会打开软件压缩
                      RDEOPT_PauseOnScript:供RasDialDlg内部使用。不能设置这个标志
                      RDEOPT_UseCustomScripting:2000/NT不支持
                      RDEOPT_CustomDial:NT不支持
hwndParent：不用，应该设为NULL
reserved：不用，设为0
reserved1：不用，设为0
RasEapInfo：NT不支持

第二个参数:电话簿文件:
电话簿不过是一个RASENTRY结构的集合，这些结构中包含了电话号码、数据速率、用户身份验证信息和其他连接信息,在2000/NT平台上，电话簿的扩展名一般是. PBK的文件中
具体结构参看window网络编程16章吧。

第三个参数:

[cpp] view plaincopy
  1. typedef struct _RASDIALPARAMS {   
  2.   DWORD     dwSize;   
  3.   TCHAR     szEntryName[RAS_MaxEntryName + 1];   
  4.   TCHAR     szPhoneNumber[RAS_MaxPhoneNumber + 1];   
  5.   TCHAR     szCallbackNumber[RAS_MaxCallbackNumber + 1];   
  6.   TCHAR     szUserName[UNLEN + 1];   
  7.   TCHAR     szPassword[PWLEN + 1];   
  8.   TCHAR     szDomain[DNLEN + 1] ;   
  9. #if (WINVER >= 0x401)  
  10.   DWORD     dwSubEntry;  
  11.   ULONG_PTR dwCallbackId;  
  12. #endif  
  13. } RASDIALPARAMS;  

 

dwSize：必须设为RASDIALPARAMS;结构的长度（按字节算）。
szEntryName：一个字串，允许你标识一个电话簿条目，该条目中包含在RasDial函数的lpszPhonebook参数中列出的电话簿文件内，如为空字串（“”）,RasDial就会选择系统上已安装的第一个可用的Modem，

并依据下一个参数szPhoneNumber来拨叫连接
szPhoneNumber:一个字串，代表一个电话号码，这个号码优先于szEntryName字段中指定的电话簿条目内包含的电话号码
szCallbackNumber：允许你指定一个电话号码， RAS服务器可以根据这个号码回拨。如果RAS服务器允许有一个回拨号码，它就会中断原来的连接，利用你指定的回拨号码回拨。这个特性非常不错，因为有了它

服务器就可知道连接的用户来自何处
szUserName：一个字串，标识RAS服务器上的用户进行身份验证时所用的登录名
szPassword：一个字串，标识R A S服务器上的用户进行身份验证时所用的密码
szDomain：可选。允许你指定最初的电话簿子条目拨叫一个RAS多链路连接
dwCallbackId：允许你把一个应用程序定义的值投递到一个R a s D i a l F u n c 2回拨函数中

第四个第五个参数:
如果lpvNotifier参数设为NULL，RasDial就会置入同步模式。dwNotifierType参数就会被忽略。同步调用RasDial是使用该函数的最简单的作用；美中不足的是，同步模式下不能对连接进行监视,如果lpvNotifier

参数不为NULL，就会进入异步模式， 意味着进行连接的同时，函数调用会立即返回。可以对连接进程进行监视
    dwNotifierType:
                   0: lpvNotifier参数使用RasDialFunc函数指针管理连接事件
  1: lpvNotifier参数利用RasDialFunc1函数指针管理连接事件
                  2: lpvNotifier参数利用RasDialFunc2函数指针管理连接事件
 0xFFFFFFF: lpvNotifier参数令RasDial在连接事件期间发送一个窗口消息
分别为以下三个函数:

[cpp] view plaincopy
  1. void CALLBACK RasDialFunc(  
  2.   [in]                 UINT unMsg,  
  3.   [in]                 RASCONNSTATE rasconnstate,  
  4.   [in]                 DWORD dwError  
  5. );  

 unMsg:只可能为WM_RASDIALEVENT
 rasconnstate:接收RasDial函数即将发生的连接活动:运行、暂停和中断
 dwError: RAS错误代码

[cpp] view plaincopy
  1. void CALLBACK RasDialFunc1(  
  2.   [in]                 HRASCONN hrasconn,  
  3.   [in]                 UINT unMsg,  
  4.   [in]                 RASCONNSTATE rascs,  
  5.   [in]                 DWORD dwError,  
  6.   [in]                 DWORD dwExtendedError  
  7. );  

 

hrasconn:指向连接的句柄
dwExtendedError：扩展错误信息

[cpp] view plaincopy
  1. DWORD CALLBACK RasDialFunc2(  
  2.   [in]                 DWORD dwCallbackId,  
  3.   [in]                 DWORD dwSubEntry,  
  4.   [in]                 HRASCONN hrasconn,  
  5.   [in]                 UINT unMsg,  
  6.   [in]                 RASCONNSTATE rascs,  
  7.   [in]                 DWORD dwError,  
  8.   [in]                 DWORD dwExtendedError  
  9. );  

dwCallbackId:包含了一个应用程序定义的值，这个值最初是设在RASDIALPARAMS;结构的dwCallbackId字段中的
dwSubEntry:接收子条目电话簿索引，这个索引会再次回调RasDialFunc2函数

(2)事件通知函数

[cpp] view plaincopy
  1. DWORD RasConnectionNotification(  
  2.   __in          HRASCONN hrasconn,  
  3.   __in          HANDLE hEvent,  
  4.   __in          DWORD dwFlags  
  5. );  

hrasconn:RasDial返回的一个连接句柄，如为INVALID_HANDLE_VALUE（要强制转换成HRASCONN)
hEvent:CreateEvent创建
dwFlags:
        RASCN_Connection:当hrasconn为INVALID_HANDLE_VALUE,任何一次RAS连接都会触发这一事件
        RASCN_Disconnection:当hrasconn为INVALID_HANDLE_VALUE,任何一次RAS中止都会触发这一事件
        RASCN_BandwidthAdded:在一个多链路连接上，子条目连接会触发这一事件
        RASCN_BandwidthRemoved:在多链路连接上，子条目取消连接时，会触发这一事件

(3)

[cpp] view plaincopy
  1. DWORD RasHangUp(  
  2.   __in          HRASCONN hrasconn  
  3. );  

hrasconn:RasDial返回的一个连接句柄
注意:连接在利用一个调制解调器端口时，如果连接关闭，这个端口需要花时间重新设置这个连接。因此，你应该一直等下去，直到端口连接完全关闭为止。要做到这一点，在重新设置自己的连接时，可调用
R asGetConnectionStatus来判断连接是否完全关闭。

(4)

[cpp] view plaincopy
  1. DWORD RasGetConnectStatus(  
  2.   __in          HRASCONN hrasconn,  
  3.   __in_out      LPRASCONNSTATUS lprasconnstatus  
  4. );  

 

hrasconn:RasDial返回的一个连接句柄
lprasconnstatus:取得当前的连接状态

[cpp] view plaincopy
  1. typedef struct _RASCONNSTATUS {   
  2.   DWORD         dwSize;   
  3.   RASCONNSTATE  rasconnstate;   
  4.   DWORD         dwError;   
  5.   TCHAR         szDeviceType[RAS_MaxDeviceType + 1];   
  6.   TCHAR         szDeviceName[RAS_MaxDeviceName + 1];  
  7. #if (WINVER >= 0x401)  
  8.   TCHAR        szPhoneNumber[ RAS_MaxPhoneNumber + 1 ];  
  9. #endif // (WINVER >= 0x401)  
  10. } RASCONNSTATUS;  

 

dwSize:必须设为RASCONNSTATUS结构的长度（按字节算）。
rasconnstate:RAS连接活动状态
dwError:若RasGetConnectStatus没有返回0，就取得一个具体的R A S错误代码
szDeviceType:取得一个字串，该字串代表连接所用的设备类型
szDeviceName:取得当前的设备名
szPhoneNumber:电话号码，如*99#之类的字符串

(5)获得所有具有R A S能力的设备名及类型

[cpp] view plaincopy
  1. DWORD RasEnumDevices(  
  2.   __in          LPRASDEVINFO lpRasDevInfo,  
  3.   __in_out      LPDWORD lpcb,  
  4.   __out         LPDWORD lpcDevices  
  5. );  

 

(6)判断名字的格式是否正确，是否已包含在电话簿中

[cpp] view plaincopy
  1. DWORD RasValidateEntryName(  
  2.   __in          LPCTSTR lpszPhonebook,  
  3.   __in          LPCTSTR lpszEntry  
  4. );  

lpszPhonebook:用于识别到一个电话簿文件的路径。设为NULL，表示使用当前默认电话簿文件
lpszEntry:电话簿中没有这个名字，但该名字格式无误时，便返回ERROR_SUCCESS。若名字格式有错，这个函数就会失败，返回ERROR_INVALIDNAME；
如果电话簿中有这个名字，就会返回ERROR_ALREAD_YEXIST

(7)
RAS有四个函数，允许通过程序对电话簿RASENTRY结构进行管理。它们是：RasSet Entry、
RasGetEntryProperties、RasRenameEntry和RasDeleteEntry。如要建立一个新条目或对一个现
成的条目进行修改，可使用RasSetEntryProperties函数

(8)
可以用RasGetEntryDialParams和RasSetEntryDialParams函数来管理与具体电话
簿条目相关的用户安全凭据

RAS函数详解

标签：

原文地址：http://blog.csdn.net/jiangqin115/article/details/42236603
踩
(0)
赞
(0)
   
举报
评论 一句话评论（0）
登录后才能评论！
分享档案
更多>
2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)
周排行
mamicode.com排行更多图片
更多
友情链接
兰亭集智   国之画   百度统计   站长统计   阿里云   chrome插件   新版天听网
关于我们 - 联系我们 - 留言反馈
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码！