|
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 LINEADDRESSCAPS structure for the address have changed. The application should use lineGetAddressCaps 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
LINEADDRESSCAPS, lineGetAddressCaps, lineGetAddressStatus, lineGetStatusMessages, lineSetStatusMessages
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Unix Manual Pages
|
