OpenLine method

The OpenLine method must be called before calling any other methods in ActiveAG. OpenLine initializes a particular port for use with your program. The majority of the other ActiveAG methods will throw an exception with code AagErrLineNotOpen if OpenLine has not been called first.

The value of the line number argument must be between 0 (for the first line) and 95, the maximum number of lines supported by ActiveAG.

Note that there are several properties that only affect the system by their settings at the time this method is called. These are the Cleardown properties (see CleardownEnabled property and others) and the EchoCancelEnabled property.

Also note that – at this writing -- the value of the Protocol string must be one of:

“nocc”	No call control
“lps0”	Loop start protocol
“did0”	Direct inward dial protocol
“wnk0”	Wink start protocol
“ogt0”	Outgoing trunk protocol

The Protocol string you pass in must match the TCP file loaded by your AG.CFG file. See the topic AG hardware initialization.

Type

Arguments: LineNumber short integer

Protocol BSTR

Returns: A long integer status code (see ActiveAG Status codes)

Property interactions: None.