4.1.0.1 LINE_ADDRESSSTATE

This message is sent when the status of an address changes on a line that is currently open by the TAPI DLL. The TAPI DLL can invoke lineGetAddressStatus to determine the current status of the address.

Sent to

LINEEVENT


Parameters

HTAPILINE htLine
Specifies the TAPI DLL's opaque object handle to the line device.

HTAPICALL htCall
Unused

DWORD dwMsg
The value LINE_ADDRESSSTATE

DWORD dwParam1
Specifies the address ID of the address that changed status.

DWORD dwParam2
Specifies the address state that changed, of type LINEADDRESSSTATE. Values are:

LINEADDRESSSTATE_OTHER
An status item or multiple items in the address' status not listed below have changed. The TAPI DLL can check the current address status to determine which items have changed.

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

LINEADDRESSSTATE_INUSEZERO
The address has changed to idle; i.e., it is now in use by zero stations.

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

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

LINEADDRESSSTATE_NUMCALLS
The number of calls on the address has changed. This is the result of either a new inbound call, or an outbound call on the address, a call changing its hold status, etc.

LINEADDRESSSTATE_FORWARD
The forwarding status of the address has changed including the number of rings for determining a no answer condition. The app should check the address status to determine details about the address' current forwarding status.

LINEADDRESSSTATE_TERMINALS
The terminal settings for the address have changed.

DWORD dwParam3
Unused.

Comments

This message is sent whenever the line is open by the TAPI DLL and an event occurs in which the TAPI DLL has expressed an interest. The TAPI DLL uses the TSPI_lineSetStatusMessages function to specify the set of status-change events in which it is interested. By default, address status reporting is disabled.

See Also

Functions: TSPI_lineGetAddressStatus, TSPI_lineSetStatusMessages
Data Types: LINEADDRESSSTATUS