[New - Windows NT]
RasRenameEntry功能可更改电话簿中条目的名称。
DWORD RasRenameEntry(
LPTSTR 【lpszPhonebook】, | //指向电话簿文件的完整路径和文件名 |
LPTSTR 【lpszOldEntry】, | //指向旧条目名称 |
LPTSTR 【lpszNewEntry】 | //指向新的条目名称 |
); |
参数
【lpszPhonebook】
Windows NT:指向指定电话簿(.PBK)文件的完整路径和文件名的以空值终止的字符串的指针。如果此参数为NULL,则该函数使用当前的默认电话簿文件。默认电话簿文件是用户在拨号网络对话框的用户首选项属性表中选择的文件。
【lpszOldEntry】
指向包含现有条目名称的以null结尾的字符串。
【lpszNewEntry】
指向包含新条目名称的以null结尾的字符串。在致电RasRenameEntry之前,请调用RasValidateEntryName以验证新的条目名称。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值是以下错误代码之一。
值 | 含义 |
ERROR_INVALID_NAME | 【lpszNewEntry】名称无效。 |
ERROR_ALREADY_EXISTS | 具有【lpszNewEntry】名称的条目已存在。 |
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY | 电话簿条目不存在。 |
也可以看看