LINEFORWARD

The LINEFORWARD structure describes an entry of the forwarding instructions.

typedef struct lineforward_tag {
    DWORD  dwForwardMode;

    DWORD  dwCallerAddressSize;
    DWORD  dwCallerAddressOffset;

    DWORD  dwDestCountryCode;
    DWORD  dwDestAddressSize;
    DWORD  dwDestAddressOffset;
} LINEFORWARD, FAR *LPLINEFORWARD;
 

Members

dwForwardMode

The types of forwarding, of type LINEFORWARDMODE_. The dwForwardMode member can have only a single bit set. Values are:

LINEFORWARDMODE_UNCOND

Forward all calls unconditionally, irrespective 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

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

LINEFORWARDMODE_UNCONDEXTERNAL

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

LINEFORWARDMODE_UNCONDSPECIFIC

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

LINEFORWARDMODE_BUSY

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

LINEFORWARDMODE_BUSYINTERNAL

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

LINEFORWARDMODE_BUSYEXTERNAL

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

LINEFORWARDMODE_BUSYSPECIFIC

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

LINEFORWARDMODE_NOANSW

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

LINEFORWARDMODE_NOANSWINTERNAL

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

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

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

LINEFORWARDMODE_BUSYNA

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

LINEFORWARDMODE_BUSYNAINTERNAL

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

LINEFORWARDMODE_BUSYNAEXTERNAL

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

LINEFORWARDMODE_BUSYNASPECIFIC

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

dwCallerAddressSize

dwCallerAddressOffset

The size in bytes and the offset from the beginning of the containing data structure in bytes of the variably sized address field containing the address of a caller to be forwarded. The dwCallerAddressSize/Offset member is set to zero if dwForwardMode is not one of the following: LINEFORWARDMODE_BUSYNASPECIFIC, LINEFORWARDMODE_NOANSWSPECIFIC, LINEFORWARDMODE_UNCONDSPECIFIC, or LINEFORWARDMODE_BUSYSPECIFIC.

The offset dwCallerAddressOffset in the variably sized field of type LINEFORWARD pointed at by dwForwardSize/Offset is relative to the beginning of the LINEADDRESSSTATUS data structure (the "root" container).

dwDestCountryCode

The country code of the destination address where the call is to be forwarded.

dwDestAddressSize

dwDestAddressOffset

The size in bytes and the offset from the beginning of the containing data structure in bytes of the variably sized address field containing the address of the address where calls are to be forwarded.

The offset dwDestAddressOffset in the variably sized field of type LINEFORWARD pointed at by dwForwardSize/Offset is relative to the beginning of the LINEADDRESSSTATUS data structure (the "root" container).

Remarks

Not extensible.

Each entry in the LINEFORWARD structure specifies a forwarding request.

See Also

LINE_ADDRESSSTATE, LINECALLORIGIN_ Constants, LINEFORWARDLIST, LINEFORWARDMODE_ Constants, TSPI_lineForward, TSPI_lineGetAddressStatus