lineGetTranslateCaps (Windows CE 5.0)
This function returns address translation capabilities.
LONGlineGetTranslateCaps(HLINEAPPhLineApp, DWORDdwAPIVersion, LPLINETRANSLATECAPSlpTranslateCaps);
Parameters
- hLineApp
[in] Application handle returned by the lineInitialize function. If an application has not yet called lineInitialize, it can set the hLineApp parameter to NULL. - dwAPIVersion
[in] The highest version of TAPI supported by the application (not necessarily the value negotiated by the lineNegotiateAPIVersion function on some particular line device). - lpTranslateCaps
[out] Pointer to where 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. The following table shows the return values for this function.
| Value | Description |
|---|---|
| LINEERR_INVALAPPHANDLE | Invalid handle |
| LINEERR_NOMEM | No memory is available |
| LINEERR_INCOMPATIBLEAPIVERSION | Incompatiple API version |
| LINEERR_OPERATIONFAILED | The operation failed |
| LINEERR_INIFILECORRUPT | The INI file is corrupted |
| LINEERR_RESOURCEUNAVAIL | The resource is unavailable |
| LINEERR_INVALPOINTER | The pointer is invalid |
| LINEERR_STRUCTURETOOSMALL | The structure is too small |
| LINEERR_NODRIVER | No driver was found |
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.
See Also
lineInitialize | lineNegotiateAPIVersion | LINETRANSLATECAPS
Send Feedback on this topic to the authors