McDewey

Multi-vendor documentation library · semantic search · MCP endpoint at /mcp

Page 207

↗ View in doc context
page
207
source
cucm/v15/tapi-dev-guide/tapi-dev-guide.md
chunk_id
cucm::v15::tapi-dev-guide::tapi-dev-guide::210

A handle to the call that is to be placed on hold. Ensure that the application is an owner of the call and the call state of hCall is connected. lineInitialize Although the lineInitialize function is obsolete, tapi.dll and tapi32.dll continue to export it for backward compatibility with applications that are using API versions 1.3 and 1.4. Function Details LONG WINAPI lineInitialize( LPHLINEAPP lphLineApp, HINSTANCE hInstance, LINECALLBACK lpfnCallback, LPCSTR lpszAppName, LPDWORD lpdwNumDevs ); Parameters lphLineApp A pointer to a location that is filled with the application's usage handle for TAPI. hInstance The instance handle of the client application or DLL. lpfnCallback The address of a callback function that is invoked to determine status and events on the line device, addresses, or calls. For more information, see lineCallbackFunc. lpszAppName A pointer to a null-terminated text string that contains only displayable characters. If this parameter is not NULL, it contains an application-supplied name for the application. The LINECALLINFO structure provides this name to indicate, in a user-friendly way, which application originated, originally accepted, or answered the call. This information can prove useful for call logging purposes. If lpszAppName is NULL, the application's file name gets used instead. lpdwNumDevs A pointer to a DWORD-sized location. Upon successful completion of this request, this location gets filled with the number of line devices that is available to the application. Return Values Returns zero if the request succeeds or a negative number if an error occurs. Possible return values follow: • LINEERR_INVALAPPNAME • LINEERR_OPERATIONFAILED • LINEERR_INIFILECORRUPT • LINEERR_RESOURCEUNAVAIL • LINEERR_INVALPOINTER Cisco Unified TAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs 175 Basic TAPI Implementation lineInitialize

Page 207 content