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).
ConstantDescription
RASPBDFLAG_PositionDlgCauses 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_ForceCloseOnDialTurns 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_NoUserCauses 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_UpdateDefaultsCauses 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

Used WinApi functions

RasPhonebookDlg