C++
C#
VB
JScript
All

Method IGroup.­Dial­Call

Owner Object Model

Function DialCall( ByVal RemoteParty As String,
                Optional ByVal LocalParty As String = "",
                Optional ByVal GuaranteedExtension As Boolean = 0,
                Optional ByVal Qualifications As Long = 0,
                Optional ByVal NoAnswerTimeout As Double = 30.0,
                Optional ByVal TrunkGroup As Variant,
                Optional ByVal PostConnectDTMF As String = "",
                Optional ByVal RecordFile As String = "",
                Optional ByVal HangUpFile As String = "",
                Optional ByVal ExtendedParameters As String = "" ) As ICall

Dials an outbound call for the group.

Parameters

Input argumentRemoteParty

The remote telephone number to dial.
Input argumentLocalParty

The originating telephone number to report. If no value is specified then the dialer-configured value will be used. The following special values may also be specified:

  • allowed

    allowing presentation of the ISDN line's phone number.
  • blocked

    presentation restricted (CLIR).
Input argumentGuaranteedExtension

If True then an extension is reserved for the call even before the call is placed. This guarantees the call can be connected to an extension when the call is answered. If there is no suitable extension available then the DialCall method immediately returns an error. If GuaranteedExtension is False then the call is dialed without regard to the available extensions, under the assumption that even if there isn't an available extension now then there will be one available by the time the call is connected. By default GuaranteedExtension is False.
Input argumentQualifications

32-bit value that specifies the required qualifications of the extension to assign the call to when connected.
Input argumentNoAnswerTimeout

The length of time (in seconds) before it is assumed the call will not be answered. When the NoAnswerTimeout expires, the call terminates with an outcome of coNoAnswer. The default no-answer time-out is 30 seconds.
Input argumentTrunkGroup

The trunk group used to dial the call. This must be a number between 0 and 999 and correspond to a trunk group configure for the dialer. If no trunk group is specified then a free trunk is chosen automatically (this is the default).
Input argumentPostConnectDTMF

DTMF sequence that is played automatically when the call is connected. This can contain all 16 DTMF tones (0 to 9, A to D, *, and #) and comma (,) and full stop (.) for a short and long pause respectively. If this isn't specified no DTMF tones are played.
Input argumentRecordFile

The name of the file to use to record the entire call to. If this isn't specified the entire call isn't recorded (the is the default behavior).
Input argumentHangUpFile

The name of the file to play when a nuisance hang-up occurs. The hang-up file is played and the call is then hung up. A nuisance hang-up occurs when the call is answered but no interviewer is available within the HoldTime to take the call.
Input argumentExtendedParameters

Extended parameters to pass to the dialer for the call. For example answering machine detection settings, “amd=1,max:4.5”

Return Value

The Call object corresponding to the call that was dialed.

Remarks

The DialCall() method creates a Call object, adds it to the ActiveCalls lists of the Dialer and Group objects, and dials a call.