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()