Share via


TSPI_lineGetCallAddressID (Windows Embedded CE 6.0)

1/6/2010

This function retrieves the address identifier for the indicated call.

Syntax

LONG TSPIAPI TSPI_lineGetCallAddressID(
  HDRVCALL hdCall, 
  LPDWORD lpdwAddressID 
);

Parameters

  • hdCall
    Service provider's handle to the call whose address identifier is to be retrieved. The call state of hdCall can be any state.
  • lpdwAddressID
    Pointer to a DWORD into which the service provider writes the call's address identifier.

Return Value

Returns 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_NOMEM

Not enough memory is available.

LINEERR_OPERATIONFAILED

The operation failed.

LINEERR_OPERATIONUNAVAIL

The operation is unavailable.

LINEERR_RESOURCEUNAVAIL

The resource is unavailable.

Remarks

If the service provider models lines as "pools" of channel resources and does inverse multiplexing of a call over several address identifiers, it should consistently choose one of these address identifiers as the primary identifier reported by this function and in the LINECALLINFO data structure.

This function has no direct correspondence at the TAPI level. It gives TAPI sufficient information to implement the lineGetNewCalls function invoked with the LINECALLSELECT_ADDRESS option.

Requirements

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

See Also

Reference

TSPI Line Device Functions