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 function returns when the dialog box closes.
RasPhonebookDlgEx([cInitialSelectedEntry [, cPhonebook [, cCallback [, nFlags]]]])
Parameters
- cInitialSelectedEntry (optional)
default = empty
The name of the phonebookentry which should be initially selected in the dialog.
- cPhonebook (optional)
default = empty
If cPhonebook is empty the system default phonebook is used otherwise the it should specify a valid phonebook filename.
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.
- cCallback (optional)
default = empty
If this parameter is empty no callbacks are made from the dialog.
Otherwise the passed function is called back while the dialog is running.
The function should have the following prototype.
FUNCTION DialogCallback(lnEvent, lcText, lnData) DO CASE CASE lnEvent = RASPBDEVENT_AddEntry ? "RasEntry added: ", lcText CASE lnEvent = RASPBDEVENT_EditEntry ? "RasEntry edited: ", lcText CASE lnEvent = RASPBDEVENT_RemoveEntry ? "RasEntry removed: ", lcText CASE lnEvent = RASPBDEVENT_DialEntry ? "RasEntry dialed: ", lcText CASE lnEvent = RASPBDEVENT_EditGlobals ? "RasEntry (global) edited: ", lcText CASE lnEvent = RASPBDEVENT_NoUser ? "RasEntry NoUser event" CASE lnEvent = RASPBDEVENT_NoUserEdit ? "RasEntry NoUserEdit event" ENDCASE ENDFUNC
- nFlags (optional)
default = 0
One or a combition of the following values (defined in rasapi32.h). Constant Description RASPBDFLAG_PositionDlg Causes RasPhonebookDlg to use the values specified by the xDlg and yDlg members to position the dialog box. If this flag is not set, the dialog box is centered on the owner window, unless hwndOwner is NULL, in which case, the dialog box is centered on the screen. RASPBDFLAG_ForceCloseOnDial Turns on the close-on-dial option, overriding the user's preference. This option is appropriate with features such as RAS AutoDial where the user's goal is to make a connection immediately. RASPBDFLAG_NoUser Causes the RasPBDlgFunc callback function specified by the pCallback member to receive a RASPBDEVENT_NoUser notification when the dialog box is starting up. This flag is for use in situations in which there is no logged-on user, as in the WinLogon application. Typically, applications should not use this flag. RASPBDFLAG_UpdateDefaults Causes the default window position to be saved on exit. This flag is used primarily by RASPHONE.EXE and should not be used by typical applications.
Return Value
.T. if a RAS connection was established, .F. if the dialog was aborted.
See Also
Reference
AbortRasConnectionNotification
ARasConnections
ARasDevices
ARasPhonebookEntries
RasClearConnectionStatistics
RasConnectionNotificationEx
RasDialDlgEx
RasDialEx
RasGetConnectStatusEx
RasHangUpEx