2.2.3.1.4 LINEADDRESSSTATE_Constants

  • Article

The LINEADDRESSSTATE_Constants are bit-flag constants that describe various address status items.

Constant/value

Description

LINEADDRESSSTATE_OTHER

0x00000001

Address-status items other than those that are listed below have changed. The application must check the current address status to determine which items have changed.

LINEADDRESSSTATE_DEVSPECIFIC

0x00000002

The device-specific item of the address status has changed.

LINEADDRESSSTATE_INUSEZERO

0x00000004

The address has changed to idle (it is not in use by any stations).

LINEADDRESSSTATE_INUSEONE

0x00000008

The address has changed from idle or being in use by many bridged stations to being in use by just one station.

LINEADDRESSSTATE_INUSEMANY

0x00000010

The monitored or bridged address has changed from being in use by one station to being in use by more than one station.

LINEADDRESSSTATE_NUMCALLS

0x00000020

The number of calls on the address has changed. This change is the result of events such as a new incoming call, an outgoing call on the address, or a call changing its hold status. This flag covers changes in any of the member's dwNumActiveCalls, dwNumOnHoldCalls, and dwNumOnHoldPendingCalls in the LINEADDRESSSTATUS packet. The application checks all three of these members when it receives a LINE_ADDRESSSTATE (numCalls) packet.

LINEADDRESSSTATE_FORWARD

0x00000040

The forwarding status of the address has changed, including possibly the number of rings for determining a no-answer condition. The application is to check the address status to determine details about the current forwarding status of the address.

LINEADDRESSSTATE_TERMINALS

0x00000080

The terminal settings for the address must have changed.

The following constant is present in TAPI versions 1.4, 2.0, 2.1, 2.2, 3.0, and 3.1.

Constant/value

Description

LINEADDRESSSTATE_CAPSCHANGE

0x00000100

Indicates that, because of configuration changes made by the user or other circumstances, one or more of the members in the LINEADDRESSCAPS packet for the address have changed. The client is to use the GetAddressCaps packet to read the updated packet. If a service provider sends a LINE_ADDRESSSTATE packet that contains this value to TAPI, TAPI will pass it to applications that have negotiated TAPI versions 1.4, 2.0, 2.1, 2.2, 3.0, and 3.1. Applications that negotiate a previous version will receive LINE_LINEDEVSTATE packets that specify LINEDEVSTATE_REINIT, which requires them to shut down and reinitialize their connection to TAPI to obtain the updated information.

An application is notified about changes to these status items in the LINE_ADDRESSSTATE packet. The device capabilities of the address indicate which address state changes can be reported for this address.