LINE_ADDRESSSTATE (TSPI) (Compact 2013)
3/26/2014
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 |
tspi.h |
See Also
Reference
TSPI Messages
LINEEVENT
TSPI_lineGetAddressStatus
TSPI_lineSetStatusMessages