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