RasGetEntryDialParams功能可以检索上次成功呼叫保存的连接信息到指定电话簿条目的RasDial或RasSetEntryDialParams功能。
DWORD RasGetEntryDialParams(
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名 |
LPRASDIALPARAMS 【//指向具有新连接参数的结构的指针】, | //指向接收连接参数的结构的指针 |
LPBOOL 【lpfPassword】 | //表示是否检索到用户的密码 |
); |
参数
【lpszPhonebook】
Windows NT:指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
Windows 95:拨号网络将电话簿条目存储在注册表中,而不是电话簿文件中。
【//指向具有新连接参数的结构的指针】
指向RASDIALPARAMS结构的接收与szEntryName成员指定的电话簿条目相关联的连接参数。在输入时,的dwSize成员必须指定RASDIALPARAMS结构的大小,szEntryName成员必须指定有效的电话簿条目。
【lpfPassword】
指向一个标志,指示该函数是否检索与电话簿条目的用户名相关联的密码。如果在【//指向具有新连接参数的结构的指针】指向的RASDIALPARAMS结构的RASDIALPARAMS成员中返回用户的密码,该函数将此标志设置为TRUE。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值可以是以下错误代码之一:
值 | 描述 | |||||||||||||||||||||
ERROR_BUFFER_INVALID | ||||||||||||||||||||||
【//指向具有新连接参数的结构的指针】或【lpfPassword】指针无效,或【//指向具有新连接参数的结构的指针】缓冲区无效。 | ||||||||||||||||||||||
ERROR_CANNOT_OPEN_PHONEBOOK | ||||||||||||||||||||||
电话簿已损坏或丢失组件。 | ||||||||||||||||||||||
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY | ||||||||||||||||||||||
电话簿条目不存在。 |
也可以看看
RasDial, RASDIALPARAMS, RasCreatePhonebookEntry, RasEditPhonebookEntry, RasSetEntryDialParams