RasCreatePhonebookEntry

DWORD RasCreatePhonebookEntry(
  _In_ HWND    hwnd,
  _In_ LPCTSTR lpszPhonebook
);

说明

[该函数不建议在Windows Vista系统使用，其功能被RasDialDlg函数替代。]
该函数用于创建一个新的电话簿入口，调用该函数会显示一个窗口让用户输入电话簿信息。

参数

hwnd[in]

指定对话框的父窗口句柄。

lpszPhonebook[in]

指向一个包含完整路径的电话簿文件(PBK)。如果参数为空，则该函数使用默认的电话簿文件。默认的电话簿文件由用户在拨号网络对话框的[user preferences]属性窗口中选择。

返回值

该函数成功时返回ERROR_SUCCESS。
失败时返回下列错误码之一，或者来自Routing and Remote Access Error Codes 和 winerror.h中定义的值。

值	含义
ERROR_CANNOT_OPEN_PHONEBOOK	电话簿文件损坏或组件丢失

注意事项

当调用RasDialDlg时，指向RASDIALDLG结构的lpInfo指针，其成员变量除以下成员外其它成员应设置为0：

• dwSize = sizeof(RASDIALDLG)
• hwndOwner = 以上描述的hwnd参数
• dwFlags = RASEDFLAG_NewEntry

系统支持

客户端最小支持	Windows 2000 专业版
服务端最小支持	Windows 2000 Server
客户端最高支持	Windows XP
服务端最高支持	Windows Server 2003
Header	Ras.h
Library	Rasapi32.lib
DLL	Rasapi32.dll
Unicode和Ansi名称	RasCreatePhonebookEntryW(Unicode) RasCreatePhonebookEntryA(ANSI)