2.2.3.1.6 LINEADDRFEATURE_Constants

The LINEADDRFEATURE_Constants are bit-flag constants that list the operations that can be invoked on an address.

Note If none of the new, modified PickUp bits are set in the dwAddressFeatures member in the LINEADDRESSSTATUS packet but the LINEADDRFEATURE_PICKUP bit is set, any of the pickup modes can work; the service provider has simply not specified which modes.

Constant/value

Description

LINEADDRFEATURE_FORWARD

0x00000001

The address can be forwarded.

LINEADDRFEATURE_MAKECALL

0x00000002

An outgoing call can be placed in the address.

LINEADDRFEATURE_PICKUP

0x00000004

A call can be picked up at the address.

LINEADDRFEATURE_SETMEDIACONTROL

0x00000008

Media control can be set on this address.

LINEADDRFEATURE_SETTERMINAL

0x00000010

The terminal modes for this address can be set.

LINEADDRFEATURE_SETUPCONF

0x00000020

A conference call with a NULL initial call can be set up at this address.

LINEADDRFEATURE_UNCOMPLETECALL

0x00000040

Call completion requests can be canceled at this address.

LINEADDRFEATURE_UNPARK

0x00000080

Calls can be unparked using this address.

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

Constant/value

Description

LINEADDRFEATURE_PICKUPHELD

0x00000100

The PickUp packet (with a null destination address) can be used to pick up a call that is held on the address. This ability must normally be used only in a bridged-exclusive arrangement.

LINEADDRFEATURE_PICKUPGROUP

0x00000200

The PickUp packet can be used to pick up a call in the group.

LINEADDRFEATURE_PICKUPDIRECT

0x00000400

The PickUp packet can be used to pick up a call on a specific address.

LINEADDRFEATURE_PICKUPWAITING

0x00000800

The PickUp packet (with a null destination address) can be used to pick up a call-waiting call. It does not necessarily indicate that a waiting call is actually present because it is often impossible for a telephony device to automatically detect such a call. It must, however, indicate that the hook-flash function (a button on a telephone that simulates a quick off-hook/on-hook/off-hook cycle) will be invoked to attempt to switch to such a call.

LINEADDRFEATURE_FORWARDFWD

0x00001000

The Forward packet can be used to forward calls on the address to other numbers. LINEADDRFEATURE_FORWARD must also be set.

Note If any of the "FORWARD" bits are set in the dwAddressFeatures member in LINEADDRESSSTATUS but the LINEADDRFEATURE_FORWARD bit is set, any of the forward modes can work; the service provider has simply not specified which ones.

LINEADDRFEATURE_FORWARDDND

0x00002000

The Forward packet (with an empty destination address) can be used to turn on the Do Not Disturb feature on the address. LINEADDRFEATURE_FORWARD must also be set.

This constant MUST be used both in LINEADDRESSCAPS (returned by the GetAddressCaps packet) and in LINEADDRESSSTATUS (returned by the GetAddressStatus packet). LINEADDRESSCAPS reports the availability of the address features by the service provider (mainly the switch) for a specified address. The LINEADDRESSSTATUS packet reports, for a specified address, which address features can actually be invoked while the address is in the current state.