RasCreatePhonebookEntryA 函数 (ras.h)

[从 Windows Vista 开始,此函数已弃用,其功能已被 RasDialDlg 取代。 ]

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

语法

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

parameters

[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 [仅限桌面应用]
目标平台 Windows
标头 ras.h
Library Rasapi32.lib
DLL Rasapi32.dll

请参阅

RasEditPhonebookEntry

RasEntryDlg

RasGetEntryDialParams

RasSetEntryDialParams

远程访问服务 (RAS) 概述

远程访问服务功能