Share via


RasRenameEntry (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.