FaxCalling method

This method provides a great deal of flexibility to your program. It is designed for use on lines that have calls connected – it is not designed to originate (place) calls. It can be used after the succesful completion of the AnswerCall method method or the PlaceCall method or PlaceCallAsync method.

FaxCalling is a method that allows your program to respond to conditions during a call in a very flexible way. It’s primary purpose is to detect the presence of a fax terminal by looking for CNG tone. (It uses the tone detector of the ADI service in CT Access to do this.) It also gives you the options of setting a time-out value for this detection and of playing a voice message before starting the tone detector to look for the CNG tone.

The return values from this method indicate what it detected:

0 CNG detected

1 call disconnected

2 ADI error

3 No CNG detected (before timing out)

4 Message finished playing

5 Touch tone detected

Because of the number of options available this method can be used in many different ways.

Type

Arguments: VoxFileName BSTR

MsgNum unsigned long integer

TimeOut long integer

(0 indicates no timer is desired)

Returns: One of the values described above.

Property interactions: None.

NOTE: In order for this FAX method to work, the version of ActiveAG that supports FAX must be installed. Other versions of ActiveAG will throw an exception with the code AagErrMethodNotAvail.

To install the version of ActiveAG that supports FAX requires that NMS’ NaturalFax software be installed previously. See the Installation Notes topic.