RasSetEntryDialParams功能将上次成功呼叫保存的连接信息更改为指定电话簿条目的RasDial或RasSetEntryDialParams功能。
DWORD RasSetEntryDialParams(af
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名的指针 |
LPRASDIALPARAMS 【//指向具有新连接参数的结构的指针】, | //指向具有新连接参数的结构的指针 |
BOOL 【fRemovePassword】 | //表示是否从条目的参数中删除密码 |
); |
参数
【lpszPhonebook】
Windows NT:指向指定电话簿(.PBK)文件的完整路径和文件名的空终止字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
Windows 95:拨号网络将电话簿条目存储在注册表中,而不是在电话簿文件中。
【//指向具有新连接参数的结构的指针】
指向RASDIALPARAMS结构,其中包含与电话簿条目关联的连接参数。RasSetEntryDialParams使用结构的成员如下:
会员 | 描述 |
的dwSize | 必须指定sizeof(RASDIALPARAMS)以标识结构的版本。 |
szEntryName | 用于标识电话簿条目以设置参数的空终止字符串。 |
szPhoneNumber | 不曾用过。设置为NULL。 |
szCallbackNumber | 一个包含回叫电话号码的以null结尾的字符串。如果szCallbackNumber为空字符串(“”),则回调号码不会更改。 |
szUserName | 包含与此条目关联的用户的登录名的空值终止的字符串。如果szUserName为空字符串,则用户名不会更改。 |
szPassword | 一个空字符串的字符串,其中包含由szUserName指定的用户的密码。如果szUserName为空字符串,密码不会更改。如果szPassword为空字符串,并且【fRemovePassword】为FALSE,则将密码设置为空字符串。如果【fRemovePassword】为TRUE,则不管szPassword字符串的内容如何,??由szUserName指定的用户存储在此电话簿条目中的密码将被删除。 |
szDomain | 一个以空字符结尾的字符串,其中包含要登录的域的名称。如果szDomain为空字符串,则不会更改域名。 |
【fRemovePassword】
指示是否删除由【//指向具有新连接参数的结构的指针】指定的用户的电话簿条目的存储密码 - > szUserName.如果【fRemovePassword】为TRUE,则会删除密码。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值可以是以下错误代码之一:
值 | 描述 | |||||||||||||||||||||
ERROR_BUFFER_INVALID | ||||||||||||||||||||||
【//指向具有新连接参数的结构的指针】指定的地址或缓冲区无效。 | ||||||||||||||||||||||
ERROR_CANNOT_OPEN_PHONEBOOK | ||||||||||||||||||||||
电话簿已损坏或丢失组件。 | ||||||||||||||||||||||
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY | ||||||||||||||||||||||
电话簿条目不存在。 |
也可以看看
RASDIALPARAMS, RasCreatePhonebookEntry, RasEditPhonebookEntry, RasGetEntryDialParams