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