Share via


LINEADDRESSSTATE

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

These bit-flag constants describe various address status items.

The following table shows the LINEADDRESSSTATE constants.

Value Description

LINEADDRESSSTATE_CAPSCHANGE = 0x00000100

Indicates that, due to configuration changes made by the user or other circumstances, one or more of the members in the LINEADDRESSCAPS structure for the address have changed. The application should use the lineGetAddressCaps function to read the updated structure. If a service provider sends a LINE_ADDRESSSTATE message containing this value to TAPI, TAPI will pass it along to applications that have negotiated TAPI version 1.4 or later; applications negotiating a previous API version will receive LINE_LINEDEVSTATE messages specifying LINEDEVSTATE_REINIT, requiring them to shut down and reinitialize their connection to TAPI to obtain the updated information.

LINEADDRESSSTATE_DEVSPECIFIC = 0x00000002

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

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 should check the address status to determine details about the address's current forwarding status.

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_INUSEONE = 0x00000008

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

LINEADDRESSSTATE_INUSEZERO = 0x00000004

The address has changed to idle. It is not in use by any stations.

LINEADDRESSSTATE_NUMCALLS = 0x00000020

The number of calls on the address has changed. This 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 members dwNumActiveCalls, dwNumOnHoldCalls and dwNumOnHoldPendingCalls in the LINEADDRESSSTATUS. The application should check all three of these members when it receives a LINE_ADDRESSSTATE (numCalls) message.

LINEADDRESSSTATE_OTHER = 0x00000001

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

LINEADDRESSSTATE_TERMINALS = 0x00000080

The terminal settings for the address have changed.

Remarks

These constants cannot be extended. All 32 bits are reserved.

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

Requirements

Header tapi.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

lineGetAddressCaps
LINEADDRESSCAPS
LINEADDRESSSTATUS
LINE_ADDRESSSTATE (TAPI)
LINE_LINEDEVSTATE (TAPI)