This function changes the name of an entry in the phone book.
At a Glance
| Header file: | Ras.h |
| Windows CE versions: | 1.0 and later |
Syntax
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.