RasPhonebookDlg
[New
- Windows NT]
The RasPhonebookDlg
function displays the main Dial-Up Networking dialog box. From this
modal dialog box, the user can dial, edit, or delete a selected phone-book
entry, create a new phone-book entry, or specify user preferences. The RasPhonebookDlg
function returns when the dialog box closes.
BOOL RasPhonebookDlg(
|
LPTSTR lpszPhonebook, |
// pointer to the
full path and filename of the phone-book file |
|
LPTSTR lpszEntry, |
// pointer to the
name of the phone-book entry to highlight |
|
LPRASPBDLG lpInfo |
// pointer to a
structure that contains additional parameters |
|
); |
|
Parameters
lpszPhonebook
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.
lpszEntry
Pointer to a
null-terminated string that contains the name of the phone-book entry to
highlight initially. If this parameter is NULL, or if the specified entry does
not exist, the dialog box highlights the first entry in the alphabetic list.
lpInfo
Pointer to a RASPBDLG structure that contains
additional input and output parameters. On input, the dwSize member of
this structure must specify sizeof(RASPBDLG). If an error occurs,
the dwError member returns an error code; otherwise, it returns zero.
Return Values
If the user
selects the Dial button and the function establishes a connection, the
return value is a nonzero value.
If an error
occurs, or if the user selects the Close button to close the dialog box,
the return value is zero. If an error occurs, the dwError member of the RASPBDLG
structure returns a nonzero system error code or RAS error code.
See Also