Share via


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

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

See Also

Reference

LINEEVENT
TSPI_lineGetAddressStatus
TSPI_lineSetStatusMessages