RasRenameEntry
This function changes the name of an entry in the phone book.
DWORD RasRenameEntry(
LPWSTR lpszPhonebook,
LPWSTR lpszOldEntry,
LPWSTR lpszNewEntry );
Parameters
- lpszPhonebook
This parameter is ignored and should be set to NULL. Phone-book entries are stored in the registry rather than in a phone-book file. - lpszOldEntry
Pointer to a null-terminated string that contains an existing entry name. - lpszNewEntry
Pointer to a null-terminated string that contains the new entry name. Before calling RasRenameEntry, call the RasValidateEntryName function to validate the new entry name.
Return Values
Zero indicates success. ERROR_INVALID_NAME indicates that the lpszNewEntry name is invalid. ERROR_ALREADY_EXISTS indicates that an entry with the lpszNewEntry name already exists. ERROR_CANNOT_FIND_PHONEBOOK_ENTRY indicates that the phone-book entry does not exist.
Include Raserror.h for definitions of the RAS error codes.
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 1.0 and later | Ras.h, Afdfunc.h | Ppp.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.