Share via

RasRenameEntry (Compact 2013)

  • Article

3/26/2014

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

See Also

Reference

RAS Functions