rasdial命令的使用

RasDial概述

参数

备注：

相关参考

使用rasdial命令制作的开机自动连接宽带

rasdial命令的使用

一、rasdial命令格式：

rasdial命令三种使用方法，先列出如下，并在其后对其做相应解释。

（一）rasdial

该命令为查看RAS连接状况，根据你是否连接到服务器，提示分为：您已经连接到 宽带连接名称（用户名），表示已经连接，并且告诉你连接的是哪个宽带连接。（一台机子可以建立多个宽带连接的，每个宽带连接需要有各自的名称，在WIN7中称为用户名。）或者为没有连接，表明你没有连接到服务器上。

（二）rasdial [entryname] /DISCONNECT

该命令用户断开宽带连接，如果只有一个宽带连接名称，则可以省略 [entryname]，即省略宽带连接名称， /DISCONNECT重的/不要忘记加。如果有多个宽带连接，则必须写上宽带连接名称。

（三）rasdial entryname [username[password|*]] [/DOMAIN:domain] [/PHONE:phonenumber] [/CALLBACK:callbacknumber] [/PHONEBOOK:phonebookfile] [/PREFIXSUFFIX]

其中[]括起来的表示可以省略，username为网络运营商（比如网通、电信）提供给你的用户名，password为密码，DOMAIN为连接到的域，PHONE为拨号连接的号码，PHONEBOOK可以从指定的文件中读取电话号，进行拨号，除了名称和密码外，其他的一般不需要设置。

二、rasdial命令的使用：

可以通过在运行栏中输入该命令运行，也可以先进入CMD或者COMMAND，然后再运行该命令，直接输入，系统会自动调用CMD命令执行。

也可以通过批处理命令，以及高级语言，比如C、C++、JAVA调用该命令，以实现功能更为丰富的拨号任务。

比如实现自动拨号，可以写 rasdial "宽带连接名称" 宽带连接用户名 宽带连接密码 这条语句，注意其中的宽带连接名称要加引号，是英文的双引号，每一项中间隔一个空格。将其用记事本写入，保存为扩展名为bat或者cmd的文件。将其放入启动项，则可以实现开机自动启动，然后进行自动拨号。

“C:\\Documents and Settings\\Administrator\\「开始」菜单\\程序\\启动”，该目录一般为开机启动项的存放目录，也可以在开始栏里找到。

RasDial概述

本函数建立RAS 客户端和服务器端的一个连接。这个连接包括和返回用户验证信息。

函数原型：

DWORD RasDial(

LPRASDIALEXTENSIONS dialExtensions,

LPTSTR phoneBookPath ,

LPRASDIALPARAMS rasDialParam ,

DWORD NotifierType,

LPVOID notifier,

LPHRASCONN pRasConn );

参数

dialExtensions

本参数可以被忽略并且可以设置为NULL,在Windows CE,RasDial 总是使用RASDIALEXTENSIONS 当做默认选项。

phoneBookPath

本参数可以被忽略并且可以设置为NULL，通过电话簿存储进行拨号上网注册，而不是通过电话簿文件。

rasDialParam

一个指向RASDIALPARAMS 结构的指针，用来描述 RAS连接的调用参数。调用者必须设置RASDIALPARAMS 结构的 dwSize成员(即结构大小)，用sizeof(RASDIALPARAMS)取得大小，防止不同版本的系统取得的大小不同

NotifierType

描述通告程序的参数性质。如果通告程序为NULL,本参数可以忽略，如果非空，则设置本参数为下面值：

0xFFFFFFFF 通过程序是一个句柄，是窗体接收通告程序消息用的。在通告程序进行中，wParam参数指示 RAS连接将要进入的连接状态。当发生错误时lParam里存储错误信息。

通告程序处理时，使用的消息是：WM_RASDIALEVENT。

notifier

一个指针，指向窗体句柄，用来接收RasDial的通告事件。如果本参数非空，RasDial为每一个通告事件发送一个windows消息。RasDial调用异步操作:在建立连接之前RasDial立即返回，使用窗体进行进程通信。

如果本参数被设置为：NULL,RasDial 调用同步操作：RasDial不立即返回，直到连接成功或者连接失败。

如果本参数非空,在调用RasDial之后，窗体通知会在任何时候出现。当下列事件发生时通知结束：

连接被建立，换句话说，RAS的连接状态是RASCS_Connected

连接失败，换句话说，dwError 非零

RasHangUp在连接时被调用

在RasDial最初被调用时，在线程获取上下文时产生回调通知

pRasConn

一个HRASCONN类型的指针，必须设置HRASCONN 类型变量为空在调用RasDial前。如果RasDial成功，本函数存储一个RAS连接句柄在本参数中。

返回值：

0表示成功。而且本函数存储一个RAS连接的句柄的指针在pRasConn中

非0值表示错误。错误的宏定义在RAS头文件中 例如：ERROR_NOT_ENOUGH_MEMORY内存不足，在Raserror.h中定义错误的宏定义

备注：

RASDIALPARAMS结构的szCallBackNumber和szPhoneNumber成员 被参数 rasDialParam指向 如果不适用设置为NULL

RasDial 不会列出上网登陆对话框，RasDial通过远程网络应用使用。应用程序负责获得用户信息。

错误产生后，通过调用RasGetConnectStatus可以立即返回错误。 可用数据直到调用 RasHangUp 函数才失效。在一个非空连接句柄被存储到pRasConn时应用程序最终调用RasHangUp。 即使RasDial返回一个非零值，(即发生了错误)，仍然要调用RasHangUp。一个应用程序能够安全的从RasDial产生的句柄调用RasHangUp。如果RasHangUp 成功了，通常程序在返回时才结束。只有在支持PostMessage函数时，窗体基础句柄要想工作。

必要条件：

操作系统: Windows CE

版本：大于等于1.0

定义位置：Ras.h, Afdfunc.h

预处理lib文件 Ppp.lib

注：

本API是微软公司提供的完整 Windows CE操作系统包的一部分。这个功能取决于原始设备制造商，有些设备可能不支持这个API。

相关参考

RasGetConnectStatus, RasHangUp, RASDIALPARAMS, WM_RASDIALEVENT

后卫大师制作版15:55 2009-9-3

使用rasdial命令制作的开机自动连接宽带

新建记事本—输入“rasdial 宽带连接 ‘你的宽带连接账号’ ‘你的宽带连接密码’”，另存为*.bat（此BAT可以为任何名字，随便起），然后找到“C:\\Documents and Settings\\Administrator\\「开始」菜单\\程序\\启动”，即开始启动文件夹，把此bat放在里面即可实现开机自动拨号连接宽带。