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 function informs the service provider that the user-user information contained in the LINECALLINFOstructure has been processed, and that subsequently received user-user information can now be written into that structure. The service provider sends a LINE_CALLINFOmessage indicating LINECALLINFOSTATE_USERUSERINFO when new information is available.

Syntax 

LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
  DRV_REQUESTID 
dwRequestID,  
  HDRVCALL 
hdCall 
);

Parameters

dwRequestID

Identifier of the asynchronous request.

hdCall

Service provider's handle to the call for which user-user information is to be released. The call state of hdCallcan be any.

Return Value

Returns dwRequestID, or an error number if an error occurs. The lResultactual parameter of the corresponding ASYNC_COMPLETIONis zero if the function succeeds, or an error number if an error occurs. The following table shows the return values for this function.

Value Description

LINEERR_INVALCALLHANDLE

The handle to the call is invalid.

LINEERR_OPERATIONFAILED

The operation failed.

LINEERR_NOMEM

Not enough memory is available.

LINEERR_RESOURCEUNAVAIL

The resource is unavailable.

Remarks

The TSPI_ lineReleaseUserUserInfofunction permits control of the flow of incoming user-user information on an ISDN connection. When a new, complete user-user information message is received, the service provider informs TAPI using a LINE_CALLINFOmessage (specifying LINECALLINFOSTATE_USERUSERINFO). The user-user information and other fields in LINECALLINFOcan be examined by multiple calls to the TSPI_lineGetCallInfofunction. The service provider must not overwrite previous user-user information in LINECALLINFOwith newer information until after TSPI_ lineReleaseUserUserInfohas been called. The service provider must buffer subsequently received user-user information until the previous information is released. Any remaining buffered information can be discarded when the TSPI_lineCloseCallfunction is invoked.

If this function is invoked while there is no user-user information in LINECALLINFO, the service provider should nevertheless return an indication of success.

For backward compatibility, TAPI automatically returns LINEERR_OPERATIONUNAVAIL if this function is invoked for a call on a line under the control of a service provider that does not export the function.

Requirements

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

See Also