|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| rasapi32.lib
| Header File
| ras.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
RasRenameEntry
[New - Windows NT]
The RasRenameEntry function changes the name of an entry in a phone book.
DWORD RasRenameEntry(
LPTSTR lpszPhonebook,
| // pointer to full path and filename of phone-book file
| LPTSTR lpszOldEntry,
| // pointer to the old entry name
| LPTSTR lpszNewEntry
| // pointer to the new entry name
| );
|
|
Parameters
lpszPhonebook
Windows NT: Pointer to a null-terminated string that specifies the full path and filename
of a phone-book (.PBK) file. If this parameter is NULL, the function uses the
current default phone-book file. The default phone-book file is the one selected
by the user in the User Preferences property sheet of the Dial-Up Networking dialog box.
lpszOldEntry
Pointer to a null-terminated string containing an existing entry name.
lpszNewEntry
Pointer to a null-terminated string containing the new entry name. Before
calling RasRenameEntry, call the RasValidateEntryName function to validate the new entry name.
Return Values
If the function succeeds, the return value is zero.
If the function fails, the return value is one of the following error codes.
Value
| Meaning
| ERROR_INVALID_NAME
| The lpszNewEntry name is invalid.
| ERROR_ALREADY_EXISTS
| An entry with the lpszNewEntry name already exists.
| ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
| The phone-book entry does not exist.
|
See Also
RasValidateEntryName
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
