RasRenameEntry

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function changes the name of an entry in the phone book.

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 Value

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