RasCreatePhonebookEntry功能创建一个新的电话簿条目。该函数显示一个对话框,用户在其中键入有关电话簿条目的信息。
Windows NT: RasCreatePhonebookEntry功能调用RasEntryDlg功能。为Windows NT版本4.0编写的应用程序应使用RasEntryDlg.
DWORD RasCreatePhonebookEntry
HWND 【HWND】, | //对话框的父窗口的句柄 |
LPTSTR 【lpszPhonebook】 | //指向电话簿文件的完整路径和文件名 |
); |
参数
【HWND】
处理到对话框的父窗口。
【lpszPhonebook】
Windows NT:指向指定电话簿(.PBK)文件的完整路径和文件名的空终止字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
Windows 95:拨号网络将电话簿条目存储在注册表中,而不是电话簿文件中。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值为以下错误代码:
值 | 描述 | |||||||||||||||||||||
ERROR_CANNOT_OPEN_PHONEBOOK | ||||||||||||||||||||||
电话簿已损坏或丢失组件。 |
也可以看看
RasEditPhonebookEntry, RasEntryDlg, RasGetEntryDialParams, RasSetEntryDialParams