2.2.3.1.40 LINEFORWARDMODE_Constants

The LINEFORWARDMODE_Constants are bit-flag constants that describe the conditions under which calls to an address can be forwarded.

Constant/value

Description

LINEFORWARDMODE_UNCOND

0x00000001

Forward all calls unconditionally, regardless of their origin. Use this value when unconditional forwarding for internal and external calls cannot be controlled separately. Unconditional forwarding overrides forwarding on "busy" or "no answer" conditions.

LINEFORWARDMODE_UNCONDINTERNAL

0x00000002

Forward all internal calls unconditionally. Use this value when unconditional forwarding for internal and external calls can be controlled separately.

LINEFORWARDMODE_UNCONDEXTERNAL

0x00000004

Forward all external calls unconditionally. Use this value when unconditional forwarding for internal and external calls can be controlled separately.

LINEFORWARDMODE_UNCONDSPECIFIC

0x00000008

Forward all calls unconditionally if they originated at a specified address (selective call forwarding).

LINEFORWARDMODE_BUSY

0x00000010

Forward all calls on "busy", regardless of their origin. Use this value when forwarding for internal and external calls on "busy" cannot be controlled separately.

LINEFORWARDMODE_BUSYINTERNAL

0x00000020

Forward all internal calls on "busy". Use this value when forwarding for internal and external calls on "busy" can be controlled separately.

LINEFORWARDMODE_BUSYEXTERNAL

0x00000040

Forward all external calls on "busy". Use this value when forwarding for internal and external calls on "busy" can be controlled separately.

LINEFORWARDMODE_BUSYSPECIFIC

0x00000080

Forward on "busy" all calls that originated at a specified address (selective call forwarding).

LINEFORWARDMODE_NOANSW

0x00000100

Forward all calls on "no answer", regardless of their origin. Use this value when call forwarding for internal and external calls on "no answer" cannot be controlled separately.

LINEFORWARDMODE_NOANSWINTERNAL

0x00000200

Forward all internal calls on "no answer". Use this value when forwarding for internal and external calls on "no answer" can be controlled separately.

LINEFORWARDMODE_NOANSWEXTERNAL

0x00000400

Forward all external calls on "no answer". Use this value when forwarding for internal and external calls on "no answer" can be controlled separately.

LINEFORWARDMODE_NOANSWSPECIFIC

0x00000800

Forward on "no answer" all calls that originated at a specified address (selective call forwarding).

LINEFORWARDMODE_BUSYNA

0x00001000

Forward all calls on "busy" or "no answer", regardless of their origin. Use this value when forwarding for internal and external calls on "busy" and on "no answer" cannot be controlled separately.

LINEFORWARDMODE_BUSYNAINTERNAL

0x00002000

Forward all internal calls on "busy" or "no answer". Use this value when call forwarding on "busy" and on "no answer" cannot be controlled separately for internal calls.

LINEFORWARDMODE_BUSYNAEXTERNAL

0x00004000

Forward all external calls on "busy" and "no answer". Use this value when call forwarding on "busy" and on "no answer" cannot be controlled separately for external calls.

LINEFORWARDMODE_BUSYNASPECIFIC

0x00008000

Forward on "busy" and "no answer" all calls that originated at a specified address (selective call forwarding).

The following constants are present in TAPI versions 1.4, 2.0, 2.1, 2.2, 3.0, and 3.1.

Constant/value

Description

LINEFORWARDMODE_UNKNOWN

0x00010000

Calls are forwarded, but the conditions under which forwarding will occur are not now known. It is possible that the conditions can become known at a future time.

LINEFORWARDMODE_UNAVAIL

0x00020000

Calls are forwarded, but the conditions under which forwarding will occur are not known and will never be known by the service provider.

The bit flags that are defined by LINEFORWARDMODE_Constants are not orthogonal. Unconditional forwarding ignores any specific condition, such as "busy" or "no answer". If unconditional forwarding is not in effect, forwarding on "busy" and on "no answer" can be controlled separately or not separately. If controlled separately, the LINEFORWARDMODE_BUSY and LINEFORWARDMODE_NOANSW flags can be used separately. If not controlled separately, the flag LINEFORWARDMODE_BUSYNA MUST be used. Similarly, if forwarding of internal and external calls can be controlled separately, the LINEFORWARDMODE_INTERNAL and LINEFORWARDMODE_EXTERNAL flags can be used separately; otherwise, the combination is used.

Address capabilities indicate which forwarding modes are available for each address that is assigned to a line. An application can use the Forward packet to set forwarding conditions at the switch.

For backward compatibility, it is the responsibility of the service provider to examine the negotiated TAPI version on the line and to not use these LINEFORWARDMODE_Constants values if the negotiated version does not support them.