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.