RasCreatePhonebookEntryA 函数 (ras.h)

[自 Windows Vista 起,此函数已弃用,其功能已被 RasDialDlg所取代。 ]

RasCreatePhonebookEntry 函数创建新的电话簿条目。 该函数显示一个对话框,其中用户键入电话簿条目的信息。

语法

DWORD RasCreatePhonebookEntryA(
  [in] HWND   unnamedParam1,
  [in] LPCSTR unnamedParam2
);

参数

[in] unnamedParam1

对话框的父窗口的句柄。

[in] unnamedParam2

指向 null终止字符串的指针,该字符串指定电话簿 (PBK) 文件的完整路径和文件名。 如果此参数 NULL,则该函数使用当前的默认电话簿文件。 默认电话簿文件是用户在 用户首选项拨号网络 对话框中选择的文件。

返回值

如果函数成功,则返回值 ERROR_SUCCESS

如果函数失败,则返回值是以下错误代码之一或来自 路由和远程访问错误代码 或 Winerror.h 的值。

返回代码 描述
ERROR_CANNOT_OPEN_PHONEBOOK
电话簿已损坏或缺少组件。

言论

调用 RasDialDlg时,请将传递给 lpInfoRASDIALDLG 结构的每个成员设置为零,但以下情况除外:

  • dwSize = sizeof(RASDIALDLG
  • hwndOwner = 上面的 hwnd 参数
  • dwFlags = RASEDFLAG_NewEntry

注意

ras.h 标头将 RasCreatePhonebookEntry 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 ras.h
Rasapi32.lib
DLL Rasapi32.dll

另请参阅

RasEditPhonebookEntry

RasEntryDlg

RasGetEntryDialParams

RasSetEntryDialParams

远程访问服务(RAS)概述

远程访问服务函数