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 |
| LPTSTR lpszPhonebook, | // pointer to the full path and filename of the phone-book file |
| LPTSTR 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. | ||||||||||||||||||||||
See Also
RasCreatePhonebookEntry, RasEntryDlg, RasGetEntryDialParams, RasSetEntryDialParams