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 returns the extension identifier that the service provider supports for the indicated line device.

Syntax 

LONG TSPIAPI TSPI_lineGetExtensionID(
  DWORD 
dwDeviceID, 
  DWORD 
dwTSPIVersion, 
  LPLINEEXTENSIONID 
lpExtensionID  
);

Parameters

dwDeviceID

Line device to be queried.

dwTSPIVersion

Interface version number that was already negotiated for this device using the TSPI_lineNegotiateTSPIVersionfunction. This function operates according to the interface specification at this version level.

lpExtensionID

Pointer to a structure of type LINEEXTENSIONID. If the service provider supports provider-specific extensions, it fills this structure with the extension identifier of these extensions. If the service provider does not support extensions, it fills this structure with all zeros. (Therefore, a valid extension identifier cannot consist of all zeros.)

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

This function is typically called by TAPI in response to an application calling the lineNegotiateAPIVersionfunction. The result returned by the service provider should be appropriate for use in a subsequent call to the TSPI_lineNegotiateExtVersionfunction. An extension identifier of all zeros is not a legal extension identifier, because the all-zeros value is used to indicate that the service provider does not support extensions.

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