Establishes a RAS connection using a specified phone-book entry and the credentials of the logged-on user.

RasDialDlgEx([cPhonebook [, cPhonebookEntry [, cPhoneNumber [, nSubEntry [, nHwndOwner]]]]])

Parameters

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.

cPhonebookEntry (optional)

The name of the phonebookentry to dial.

cPhoneNumber (optional)

defaul = empty

A string that specifies a phone number that overrides the numbers stored in the phone-book entry. If this parameter is empty, RasDialDlgEx uses the numbers in the phone-book entry.

nSubEntry (optional)

default = 0

Specifies the subentry or subentries to dial. If nSubEntry is 0, RasDialDlgEx dials all subentries associated with the specified phone-book entry.
Otherwise, to indicate the index of the individual subentry to dial, nSubEntry must be a number from one to the number of subentries.

nHwndOwner (optional)

default = 0

Specifies the window that owns the modal RasDialDlgEx dialog boxes.
This parameter can be any valid window handle, or it can be 0 if the dialog box has no owner.

Return Value

.T. if a RAS connection was established, .F. if the dialog was aborted.

See Also

Reference

AbortRasConnectionNotification
ARasConnections
ARasDevices
ARasPhonebookEntries
RasClearConnectionStatistics
RasConnectionNotificationEx
RasDialEx
RasGetConnectStatusEx
RasHangUpEx
RasPhonebookDlgEx

Used WinApi functions

RasDialDlg