RAS详解
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
就直接加上
#ifndef WINVER #define WINVER 0x0501 #endif
4.具体函数介绍:
(1)
DWORD RasDial( __in LPRASDIALEXTENSIONS lpRasDialExtensions, __in LPCTSTR lpszPhonebook, __in LPRASDIALPARAMS lpRasDialParams, __in DWORD dwNotifierType, __in LPVOID lpvNotifier, __in LPHRASCONN lphRasConn );
lpRasDialExtensions：参数是一个可选指针，指向一个RASDIALEXTENSIONS结构，有了
这个结构，你的应用程序便可使用RasDial函数的扩展特性了， 可忽略，设为NULL
pszPhonebook：用于识别到一个电话簿文件的路径。设为NULL，表示使用当前默认电话簿文件
lpRasDialParams：定义了拨号和用户身份验证参数
dwNotifierType， lpvNotifier：可同步调用还是异步调用?
lphRasConn:
下面继续对此函数的内部结构解析:
第一个参数lpRasDialExtensions对应的结构体:
typedef struct tagRASDIALEXTENSIONS {
DWORD dwSize;
DWORD dwfOptions;
HWND hwndParent;
ULONG_PTR reserved;
#if (WINVER >= 0x500)
ULONG_PTR reserved1;
RASEAPINFO RasEapInfo;
#endif
} 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章吧。
第三个参数:
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：必须设为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在连接事件期间发送一个窗口消息
分别为以下三个函数:
void CALLBACK RasDialFunc( [in] UINT unMsg, [in] RASCONNSTATE rasconnstate, [in] DWORD dwError );
unMsg:只可能为WM_RASDIALEVENT
rasconnstate:接收RasDial函数即将发生的连接活动:运行、暂停和中断
dwError: RAS错误代码
void CALLBACK RasDialFunc1( [in] HRASCONN hrasconn, [in] UINT unMsg, [in] RASCONNSTATE rascs, [in] DWORD dwError, [in] DWORD dwExtendedError );
hrasconn:指向连接的句柄
dwExtendedError：扩展错误信息
DWORD CALLBACK RasDialFunc2( [in] DWORD dwCallbackId, [in] DWORD dwSubEntry, [in] HRASCONN hrasconn, [in] UINT unMsg, [in] RASCONNSTATE rascs, [in] DWORD dwError, [in] DWORD dwExtendedError );
dwCallbackId:包含了一个应用程序定义的值，这个值最初是设在RASDIALPARAMS;结构的dwCallbackId字段中的
dwSubEntry:接收子条目电话簿索引，这个索引会再次回调RasDialFunc2函数
(2)事件通知函数
DWORD RasConnectionNotification( __in HRASCONN hrasconn, __in HANDLE hEvent, __in DWORD dwFlags );
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)
DWORD RasHangUp( __in HRASCONN hrasconn );
hrasconn:RasDial返回的一个连接句柄
注意:连接在利用一个调制解调器端口时，如果连接关闭，这个端口需要花时间重新设置这个连接。因此，你应该一直等下去，直到端口连接完全关闭为止。要做到这一点，在重新设置自己的连接时，可调用
R asGetConnectionStatus来判断连接是否完全关闭。
(4)
DWORD RasGetConnectStatus( __in HRASCONN hrasconn, __in_out LPRASCONNSTATUS lprasconnstatus );
hrasconn:RasDial返回的一个连接句柄
lprasconnstatus:取得当前的连接状态
typedef struct _RASCONNSTATUS {
DWORD dwSize;
RASCONNSTATE rasconnstate;
DWORD dwError;
TCHAR szDeviceType[RAS_MaxDeviceType + 1];
TCHAR szDeviceName[RAS_MaxDeviceName + 1];
#if (WINVER >= 0x401)
TCHAR szPhoneNumber[ RAS_MaxPhoneNumber + 1 ];
#endif // (WINVER >= 0x401)
} RASCONNSTATUS;
dwSize:必须设为RASCONNSTATUS结构的长度（按字节算）。
rasconnstate:RAS连接活动状态
dwError:若RasGetConnectStatus没有返回0，就取得一个具体的R A S错误代码
szDeviceType:取得一个字串，该字串代表连接所用的设备类型
szDeviceName:取得当前的设备名
szPhoneNumber:电话号码，如*99#之类的字符串
(5)获得所有具有R A S能力的设备名及类型
DWORD RasEnumDevices( __in LPRASDEVINFO lpRasDevInfo, __in_out LPDWORD lpcb, __out LPDWORD lpcDevices );
(6)判断名字的格式是否正确，是否已包含在电话簿中
DWORD RasValidateEntryName( __in LPCTSTR lpszPhonebook, __in LPCTSTR lpszEntry );
lpszPhonebook:用于识别到一个电话簿文件的路径。设为NULL，表示使用当前默认电话簿文件
lpszEntry:电话簿中没有这个名字，但该名字格式无误时，便返回ERROR_SUCCESS。若名字格式有错，这个函数就会失败，返回ERROR_INVALIDNAME；
如果电话簿中有这个名字，就会返回ERROR_ALREAD_YEXIST
(7)
RAS有四个函数，允许通过程序对电话簿RASENTRY结构进行管理。它们是：RasSet Entry、
RasGetEntryProperties、RasRenameEntry和RasDeleteEntry。如要建立一个新条目或对一个现
成的条目进行修改，可使用RasSetEntryProperties函数
(8)
可以用RasGetEntryDialParams和RasSetEntryDialParams函数来管理与具体电话
簿条目相关的用户安全凭据
