DialUp

Establishes a dial-up connection.

Function	Group	Execution	Windows	Embedded	Thin Client
DialUp	Dial-up	Asynchronous	Supported (see note)	Supported	Supported

Note: This function is not supported on Windows 7.

Syntax

DialUp( numType, strPhonebookEntryOrModem, strUserName, strPassword, optStrDomain, strPhoneNumber )

numType

A numeric flag that specifies the content of the strPhonebookEntryorModem parameter.

0: Phonebook Name
1: Modem Name
2: Direct Connection Name

strPhonebookEntryOrModem

The Phonebook Name, Modem Name, or Direct Connection Name used to make the connection. The numType parameter specifies which of these methods is used.

strUserName

The Username to use for logging on.

strPassword

The Password to use for logging on.

optStrDomain

Optional The domain name to specify when logging on.

strPhoneNumber

The phone number to dial (used only when the parameter numType=1).

Returned value

0	OK: dialing started
−1	Error: `INDRAS.DLL` not found
−2	Error: `INDRAS.DLL` damaged
−3	Error: invalid number of parameters (minimum=5)
-4	Invalid value for the numType parameter (0 or 1)
-5	Invalid value for the strPhonebookEntryOrModem parameter (string)
-6	PhoneBook or Modem does not exist
-7	PhoneBook or Modem is in use
-8	Depends of the numType parameter: If numType = 0: Could not read properties from PhoneBook. If numType = 1: More than 1000 connections are enabled at same time.
-9	Unable to create a temporary PhoneBook.

Notes

The operating system's RAS Server executes the dial-in for Windows PC stations automatically.

Examples

Tag Name	Expression
Tag	`DialUp( 0, "OfficeDialup", "Guest", "Password" )`
Tag	`DialUp( 1, "USRobotics_SportsterFaxModem", "HR12378", "HRPass", "15125554321" )`
Tag	`DialUp( 2, "DirectDial", "Rberton", "MyPassword", "156.48.25.0")`

See also: FindModem()