lineGetTranslateCaps function (tapi.h)

The lineGetTranslateCaps function returns address translation capabilities.

Syntax

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

Parameters

hLineApp

Handle returned by the lineInitializeEx function. If an application has not yet called the lineInitializeEx function, this parameter can be zero.

Note   TAPI 1.4 applications must set this parameter to a valid hLineApp handle, as returned by the lineInitialize function.

 

dwAPIVersion

Highest version of TAPI supported by the application (not necessarily the value negotiated by lineNegotiateAPIVersion on some particular line device).

lpTranslateCaps

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

Note  If the size parameters in the structure are not correct, there is a possibility that data could get overwritten. For more information on setting structure sizes, see the memory allocation topic.

 

Return value

Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODRIVER.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi.h
Library	Tapi32.lib
DLL	Tapi32.dll

See also

Basic Telephony Services Reference

LINETRANSLATECAPS

TAPI 2.2 Reference Overview

lineInitializeEx

lineNegotiateAPIVersion