lineGetTranslateCaps

This function returns address translation capabilities.

At a Glance

Header file: Tapi.h
Windows CE versions: 1.0 and later

Syntax

LONG lineGetTranslateCaps(HLINEAPP hLineApp, DWORD dwAPIVersion, LPLINETRANSLATECAPS lpTranslateCaps);

Parameters

hLineApp

[in] Application handle returned by lineInitialize. If an application has not yet called the lineInitialize function, it can set the hLineApp parameter to NULL.

dwAPIVersion

[in] Specifies the highest version of TAPI supported by the application (not necessarily the value negotiated by lineNegotiateAPIVersion on some particular line device).

lpTranslateCaps

[out] Pointer to a location to which a LINETRANSLATECAPS structure is loaded. Prior to calling lineGetTranslateCaps, the application should set the dwTotalSize member of this structure to indicate the amount of memory available to TAPI for returning data.

Return Values

Zero indicates success. A negative error number indicates that an error occurred. Possible error values are as follows:

LINEERR_INVALAPPHANDLE LINEERR_NOMEM
LINEERR_INCOMPATIBLEAPIVERSION LINEERR_OPERATIONFAILED
LINEERR_INIFILECORRUPT LINEERR_RESOURCEUNAVAIL
LINEERR_INVALPOINTER LINEERR_STRUCTURETOOSMALL
LINEERR_NODRIVER  

See Also

lineInitialize