LINE_ADDRESSSTATE (TSPI)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message is sent to the LINEEVENT callback function when the status of an address changes on a line that is currently open by TAPI. TAPI can invoke TSPI_lineGetAddressStatus to determine the current status of the address.

Syntax

LINE_ADDRESSSTATE
    htLine = (HTAPILINE) hLineDevice;
    htCall = (HTAPICALL) 0;
    dwMsg = (DWORD) LINE_ADDRESSSTATE;
    dwParam1 = (DWORD) idAddress;
    dwParam2 = (DWORD) AddressState;
    dwParam3 = (DWORD) 0;

Parameters

• htLine
  The TAPI opaque object handle to the line device.

• htCall
  Not used.

• dwMsg
  The value LINE_ADDRESSSTATE.

• dwParam1
  The address identifier of the address that changed status.

• dwParam2
  The address state that changed. This parameter can be a combination of the LINEADDRESSSTATE_ constants.

• dwParam3
  Not used.

Remarks

This message is sent whenever the line is open by TAPI and an event occurs in which TAPI has expressed an interest. TAPI 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.

For backward compatibility, older service providers are not expected to generate this value in a LINE_ADDRESSSTATE message. If they do, the message should be handled in the same manner as for newer service providers (as described earlier).

Requirements

See Also

Reference

LINEEVENT
TSPI_lineGetAddressStatus
TSPI_lineSetStatusMessages