Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This type is a callback function implemented by TAPI and supplied to the service provider as a parameter to the TSPI_lineOpenfunction. The service provider calls this function to report events that occur on the line or on calls on the line.

Syntax 

LINEEVENT Line_Event;
void(
CALLBACK *Line_Event)(
  HTAPILINE 
htLine,
  HTAPICALL 
htCall,
  DWORD 
dwMsg,
  DWORD 
dwParam1,
  DWORD 
dwParam2,
  DWORD 
dwParam3 
);

Parameters

htLine

TAPI handle for the line on which the event occurred.

htCall

TAPI handle for the call on which the event occurred if this is a call-related event. For line-related events where there is no call, this parameter is set to NULL.

dwMsg

Value that specifies the kind of event that is being reported. Interpretation of the other parameters is performed in different ways according to the context indicated by dwMsg.

dwParam1

A parameter for the message.

dwParam2

A parameter for the message.

dwParam3

A parameter for the message.

Return Value

None.

Remarks

The call state when calling this function can be any state.

The service provider passes the HTAPILINEvalue supplied to the TSPI_lineOpenfunction as the htLineparameter. It includes the message identifier and parameters specific to the event.

This function differs from the callback function defined at the TAPI level in that it separates lineand callparameters. Both parameters are used for some messages. The sets of messages that can be passed to this procedure differ slightly from the TAPI level. In particular, completion of asynchronously executing requests is reported through the ASYNC_COMPLETIONcallback instead of this one.

Requirements

Header tapicomn.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also