Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function changes the name of an entry in the phone book.
DWORDRasRenameEntry(LPWSTRlpszPhonebook, LPWSTRlpszOldEntry, LPWSTRlpszNewEntry );
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
OS Versions: Windows CE 1.0 and later.
Header: Ras.h.
Link Library: Coredll.lib.
Send Feedback on this topic to the authors