LINE_ADDRESSSTATE
The
LINE_ADDRESSSTATE message is sent when the status of an address changes on a
line that is currently open by the application. The application can invoke lineGetAddressStatus to determine the current
status of the address.
LINE_ADDRESSSTATE
dwDevice = (DWORD) hLine;
dwCallbackInstance = (DWORD) hCallback;
dwParam1 =
(DWORD) idAddress;
dwParam2 =
(DWORD) AddressState;
dwParam3 =
(DWORD) 0;
Parameters
dwDevice
A handle to
the line device.
dwCallbackInstance
The callback
instance supplied when opening the line.
dwParam1
The address
ID of the address that changed status.
dwParam2
The address
state that changed. Can be a combination of these values:
LINEADDRESSSTATE_OTHER
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_DEVSPECIFIC
The
device-specific item of the address status has changed.
LINEADDRESSSTATE_INUSEZERO
The address
has changed to idle (it is now in use by zero stations).
LINEADDRESSSTATE_INUSEONE
The address
has changed from idle or from being used by many bridged stations to being used
by just one station.
LINEADDRESSSTATE_INUSEMANY
The monitored
or bridged address has changed from being used 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 events such as a new
inbound call, an outbound call on the address, or a call changing its hold
status.
LINEADDRESSSTATE_FORWARD
The
forwarding status of the address has changed, including 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_TERMINALS
The terminal
settings for the address have changed.
LINEADDRESSSTATE_CAPSCHANGE
Indicates
that, due to configuration changes made by the user or other circumstances, one
or more of the fields in the LINEADDRESSCAPSPFGP43 structure for the address have changed.
The application should use lineGetAddressCapsN4KBZ3 to read the updated structure.
Applications which support API versions less than 0x00010004 will receive a
LINEDEVSTATE_REINIT message, requiring them to shutdown and reinitialize their
connection to TAPI in order to obtain the updated information.
dwParam3
Unused.
Return Values
No return
value.
Remarks
The
LINE_ADDRESSSTATE message is sent to any application that has opened the line
device and that has enabled this message. The sending of this message for the
various status items can be controlled and queried using lineGetStatusMessages
and lineSetStatusMessages. By default, address status reporting is
disabled.
See Also