DialUp
Establishes a dial-up connection.
| Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
|---|---|---|---|---|---|---|
| DialUp | Dial-up | Asynchronous | Supported (see note) | Supported | Supported | Not 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:
|
| -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()