McDewey

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

Page 226

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

lpCallParams The call parameters that are used to set up the consult call. The application can specify the destination address if it wants the consult call to be dialed for it in the conference setup. lineSetupTransfer The lineSetupTransfer function initiates a transfer of the call that the hCall parameter specifies. It establishes a consultation call, lphConsultCall, on which the party can be dialed that can become the destination of the transfer. The application acquires owner privilege to the lphConsultCall parameter. Function Details LONG lineSetupTransfer( HCALL hCall, LPHCALL lphConsultCall, LPLINECALLPARAMS const lpCallParams ); Parameters hCall The handle of the call to be transferred. Ensure that the application is an owner of the call and ensure that the call state of hCall is connected. lphConsultCall A pointer to an hCall handle. This location is then loaded with a handle that identifies the temporary consultation call. When setting up a call for transfer, a consultation call automatically gets allocated that enables lineDial to dial the address that is associated with the new transfer destination of the call. The originating party can carry on a conversation over this consultation call prior to completing the transfer. The call state of hConsultCall does not apply. This transfer procedure may not be valid for some line devices. The application may need to ignore the new consultation call and remove the hold on an existing held call (using lineUnhold) to identify the destination of the transfer. On switches that support cross-address call transfer, the consultation call can exist on a different address than the call that is to be transferred. It may also be necessary to set up the consultation call as an entirely new call, by lineMakeCall, to the destination of the transfer. The address capabilities of the call specifies which forms of transfer are available. lpCallParams The dwNoAnswerTimeout attribute of the lpCallParams field is checked and, if is non-zero, used to automatically disconnect a call if it is not answered after the specified time. lineShutdown The lineShutdown function shuts down the usage of the line abstraction of the API. Function Details LONG lineShutdown( HLINEAPP hLineApp ); Cisco Unified TAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs 194 Basic TAPI Implementation lineSetupTransfer