RasRenameEntry (Windows Embedded CE 6.0)

  • Article

1/6/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

Header ras.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

RAS Functions