Reflection .NET API
Attachmate.Reflection.Emulation.OpenSystems Assembly / Attachmate.Reflection.Emulation.OpenSystems Namespace / ITerminal Interface / Dial Method / Dial(String,String,String,String,Int32,String,SpeakerOption,SpeakerVolumeOption,Boolean,Boolean) Method
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 to be displayed in the Dialing In Progress dialog box. If this option is omitted, only the phone number appears in the dialog box.
String to be sent to the modem before dialing. If omitted, Reflection uses the default initialization string.
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 Reflection to wait indefinitely. If this is empty (""), the default timeout (60 seconds) is used.
Specifies the number of times to redial if the number is busy or does not answer. Default value should be one retry.
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).
Specifies the speaker mode. The default is Dialing.
Specifies the speaker volume. The default is Medium.
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.
If true, Reflection ignores modem initialization string errors. If false, these errors are displayed in a message box.


In This Topic
    Dial(String,String,String,String,Int32,String,SpeakerOption,SpeakerVolumeOption,Boolean,Boolean) Method
    In This Topic
    Dials a modem. This method is only valid if Reflection is set to use the old modem dialer (UseModemDialerV5 = true).
    Syntax
    'Declaration
     
    
    Overloads Sub Dial( _
       ByVal phoneNumber As String, _
       ByVal description As String, _
       ByVal initString As String, _
       ByVal answerTimeout As String, _
       ByVal retryTimes As Integer, _
       ByVal retryInterval As String, _
       ByVal speakerOption As SpeakerOption, _
       ByVal speakerVolume As SpeakerVolumeOption, _
       ByVal speakerOffAfterRedial As Boolean, _
       ByVal ignoreModemErrors 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, Reflection 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 Reflection 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, Reflection ignores modem initialization string errors. If false, these errors are displayed in a message box.
    See Also