Dial(String,String,String,String,Int32,String,SpeakerOption,SpeakerVolumeOption,Boolean,Boolean) Method
In This Topic
Dials a modem. This method is only valid if InfoConnect is set to use the old modem dialer (UseModemDialerV5 = true).
Syntax
'Declaration
Overloads Sub Dial( _
ByVal As String, _
ByVal As String, _
ByVal As String, _
ByVal As String, _
ByVal As Integer, _
ByVal As String, _
ByVal As SpeakerOption, _
ByVal As SpeakerVolumeOption, _
ByVal As Boolean, _
ByVal As Boolean _
)
'Usage
Dim instance As ITerminal
Dim phoneNumber As String
Dim description As String
Dim initString As String
Dim answerTimeout As String
Dim retryTimes As Integer
Dim retryInterval As String
Dim speakerOption As SpeakerOption
Dim speakerVolume As SpeakerVolumeOption
Dim speakerOffAfterRedial As Boolean
Dim ignoreModemErrors As Boolean
instance.Dial(phoneNumber, description, initString, answerTimeout, retryTimes, retryInterval, speakerOption, speakerVolume, speakerOffAfterRedial, ignoreModemErrors)
Parameters
- phoneNumber
- The phone number to dial. The string can contain any valid modem dialing characters, such as commas (to allow dialing to pause for two seconds per comma) and hyphens and parentheses (used as separators for better readability). The string should not include any AT commands or dialing prefix commands.
- description
- Description to be displayed in the Dialing In Progress dialog box. If this option is omitted, only the phone number appears in the dialog box.
- initString
- String to be sent to the modem before dialing. If omitted, InfoConnect uses the default initialization string.
- answerTimeout
- Specifies the amount of time to wait for the host to confirm the connection. The string is specified in HH:MM:SS.hh format. A time string of "0" causes InfoConnect to wait indefinitely. If this is empty (""), the default timeout (60 seconds) is used.
- retryTimes
- Specifies the number of times to redial if the number is busy or does not answer. Default value should be one retry.
- retryInterval
- Specifies the amount of time to wait before redialing. The string is specified in HH:MM:SS.hh format. If this argument is empty (""), the default timeout is used (120 seconds).
- speakerOption
- Specifies the speaker mode. The default is Dialing.
- speakerVolume
- Specifies the speaker volume. The default is Medium.
- speakerOffAfterRedial
- If true, the modem speaker is turned off after the first dialing attempt. If false (the default) or omitted, the modem speaker remains set to the SpeakerMode for each dialing attempt.
- ignoreModemErrors
- If true, InfoConnect ignores modem initialization string errors. If false, these errors are displayed in a message box.
See Also