LINEFORWARDMODE
These bit-flag constants describe the conditions under which calls to an address can be forwarded.
The following table shows the LINEFORWARDMODE constants.
| Value | Description |
|---|---|
| LINEFORWARDMODE_BUSY = 0x00000010 | Forward all calls on busy, 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_BUSYEXTERNAL = 0x00000040 | Forward all external calls on busy. Use this value when forwarding for internal and external calls on busy and on no answer can be controlled separately. |
| LINEFORWARDMODE_BUSYINTERNAL = 0x00000020 | Forward all internal calls on busy. Use this value when forwarding for internal and external calls on busy and on no answer can be controlled separately. |
| LINEFORWARDMODE_BUSYSPECIFIC = 0x00000080 | Forward on busy all calls that originated at a specified address using a selective call forwarding scheme. |
| LINEFORWARDMODE_BUSYNA = 0x00001000 | Forward all calls on busy/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_BUSYNAEXTERNAL = 0x00004000 | Forward all external calls on busy/no answer. Use this value when call forwarding on busy and on no answer cannot be controlled separately for internal calls. |
| LINEFORWARDMODE_BUSYNAINTERNAL = 0x00002000 | Forward all internal calls on busy/no answer. Use this value when call forwarding on busy and on no answer cannot be controlled separately for internal calls. |
| LINEFORWARDMODE_BUSYNASPECIFIC = 0x00008000 | Forward on busy/no answer all calls that originated at a specified address using a selective call forwarding scheme. |
| 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_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_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_NOANSWSPECIFIC = 0x00000800 | Forward on no answer all calls that originated at a specified address (selective call forwarding). |
| 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. TAPI versions 1.4 and later. |
| 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 and/or no answer conditions. |
| LINEFORWARDMODE_UNCONDEXTERNAL = 0x00000004 | Forward all external calls unconditionally. Use this value when unconditional forwarding for internal and external calls can be controlled separately. |
| LINEFORWARDMODE_UNCONDINTERNAL = 0x00000002 | Forward all internal calls unconditionally. Use this value when unconditional forwarding for internal and external calls can be controlled separately. |
| LINEFORWARDMODE_UNCONDSPECIFIC = 0x00000008 | Unconditionally forward all calls that originated at a specified address (selective call forwarding). |
| LINEFORWARDMODE_UNKNOWN = 0x00010000 | Calls are forwarded, but the conditions under which forwarding will occur are not known at this time. It is possible that the conditions may become known at a future time. TAPI versions 1.4 and later. |
Remarks
These constants cannot be extended. All 32 bits are reserved.
The bit flags defined by LINEFORWARDMODE_ are not orthogonal. Unconditional forwarding ignores any specific condition such as busy or no answer. If unconditional forwarding is not in effect, then 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, then 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 assigned to a line. An application can use lineForward to set forwarding conditions at the switch.
For backward compatibility, it is the responsibility of the service provider to examine the negotiated API version on the line, and to not use these LINEFORWARDMODE_ values if the negotiated version does not support them.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Tapi.h.
See Also
Last updated on Saturday, April 10, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.