RasEditPhonebookEntry

The RasEditPhonebookEntry function edits an existing phone-book entry. The function displays a dialog box in which the user can modify the existing information.

Windows NT: The RasEditPhonebookEntry function calls the RasEntryDlg function. Applications written for Windows NT version 4.0 should use RasEntryDlg.

DWORD RasEditPhonebookEntry(
  HWND hwnd,             // handle to the parent window of the dialog
                         // box
  LPCTSTR lpszPhonebook, // pointer to the full path and filename of
                         // the phone-book file
  LPCTSTR lpszEntryName  // pointer to the phone-book entry name
);
 

Parameters

hwnd
Handle to the parent window of the dialog box.
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.

Windows 95: Dial-up networking stores phone-book entries in the registry rather than in a phone-book file.

lpszEntryName
Points to a null-terminated string that specifies the name of an existing entry in the phone-book file.

Return Values

If the function succeeds, the return value is zero.

If the function fails, the return value can be one of the following error codes:

Value Description
ERROR_BUFFER_INVALID
The phone-book entry buffer is invalid.
ERROR_CANNOT_OPEN_PHONEBOOK
The phone book is corrupted or missing components.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY
The phone-book entry does not exist.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ras.h.
  Import Library: Use rasapi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Remote Access Service Overview, RAS Server Administration Functions, RasCreatePhonebookEntry, RasEntryDlg, RasGetEntryDialParams, RasSetEntryDialParams