RasRenameEntry

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

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 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

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Ras.h, Afdfunc.h   Ppp.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.