LINEFORWARD structure (tapi.h)

Article
02/22/2024

The LINEFORWARD structure describes an entry of the forwarding instructions. The LINEFORWARDLIST and the LINEADDRESSSTATUS structures can contain an array of LINEFORWARD structures.

Syntax

typedef struct lineforward_tag {
  DWORD dwForwardMode;
  DWORD dwCallerAddressSize;
  DWORD dwCallerAddressOffset;
  DWORD dwDestCountryCode;
  DWORD dwDestAddressSize;
  DWORD dwDestAddressOffset;
  DWORD dwCallerAddressType;
  DWORD dwDestAddressType;
} LINEFORWARD, *LPLINEFORWARD;

Members

dwForwardMode

Types of forwarding. This member uses one of the LINEFORWARDMODE_ Constants.

dwCallerAddressSize

Size of the variably sized field containing the address of a caller to be forwarded, in bytes.

dwCallerAddressOffset

Offset from the beginning of this structure to the variably sized field containing the address of a caller to be forwarded. This member is set to zero if dwForwardMode is not one of the following values:

LINEFORWARDMODE_BUSYNASPECIFIC

LINEFORWARDMODE_NOANSWSPECIFIC

LINEFORWARDMODE_UNCONDSPECIFIC

LINEFORWARDMODE_BUSYSPECIFIC

The size of the field is specified by dwCallerAddressSize.

dwDestCountryCode

Country or region code of the destination address to which the call is to be forwarded.

dwDestAddressSize

Size of the variably sized field containing the address of the address where calls are to be forwarded, in bytes.

dwDestAddressOffset

Offset from the beginning of this structure to the variably sized field containing the address of the address where calls are to be forwarded. The size of the field is specified by dwDestAddressSize.

dwCallerAddressType

Address type of the caller. This member of the structure is available only if the negotiated version of TAPI is 3.1 or higher.

dwDestAddressType

Address type for the called destination. This member of the structure is available only if the negotiated version of TAPI is 3.1 or higher.

Remarks

This structure may not be extended.

Each entry in the LINEFORWARD structure specifies a forwarding request.

Requirements

Requirement	Value
Header	tapi.h

Share via