RasGetEntryDialParams

通过对RasDial的成功调用，本函数调用后返回连接信息被保存为电话簿入口。

函数原型：

DWORD RasGetEntryDialParams(

LPWSTR lpszPhoneBook,

LPRASDIALPARAMS lpRasDialParams,

LPBOOL lpfPassword );

参数:

lpszPhoneBook

Windows CE:本参数被忽视，或者设置为NULL，通过电话簿存储进行拨号上网注册，而不是通过电话簿文件。

lpRasDialParams

一个指向RASDIALPARAMS结构的指针，在输入时，dwSize成员必须被 RASDIALPARAMS结构指定大小。并且szEntryName 成员必须被指定一个有效地电话簿入口，输出时结构接收一个已经被指定电话簿入口相关联的连接参数。

注意：szPhoneNumber 成员不能接到与电话簿入口相关联的电话号码，要想获得的电话号码需要调用 RasGetEntryProperties 函数

pfPassword

一个BOOL类型指针，表示函数是否能通过电话簿入口返回和用户名相关联的密码，函数设置该标志位为TRUE时，用户的密码返回到lpRasDialParams 参数指向的RASDIALPARAMS 结构的szPassword 成员中

返回值：

0表示成功。ERROR_BUFFER_INVALID 表示lpRasDialParams 或者 lpfPassword 指针是无效的。或者lpRasDialParams 得缓冲区是无效的。ERROR_CANNOT_OPEN_PHONEBOOK 表示电话簿被损坏或者丢失组件。ERROR_CANNOT_FIND_PHONEBOOK_ENTRY 表示电话簿的入口不存在。

RAS错误的宏，定义在Raserror.h头文件中，包含Raserror.h头文件取得错误定义。

Windows CE 备注：

lpRasDialParams 的szCallBackNumber 和 szPhoneNumber 成员如果不使用，设置为NULL。

当参数 lpRasDialParams指向的RASDIALPARAMS 结构的dwSize 成员时,lpRasDialParams 已经被初始化了，或者被设置了错误的值。如果RasGetEntryDialParams 函数失败，则返回一个有误导性的错误值 ERROR_CANNOT_FIND_PHONEBOOK_ENTRY

注意本函数需要一个纯文本密码，但是本函数不能返回一个纯文本密码。因此只能可信应用程序才能够被用来调用RasGetEntryDialParams。

另外应该执行安全设备，并且鼓励用户使用一个强力密码。防止用户从设备上搜索密码

必备条件

操作系统 Windows CE

版本 大于等于1.0

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

预处理lib文件Ppp.lib

注：

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

相关参考：

RasDial, RASDIALPARAMS, RasSetEntryDialParams

后卫大师制作版17:22 2009-9-3