Share via

TSPI_lineSwapHold (Compact 2013)

  • Article

3/26/2014

This function swaps the specified active call with the specified call on consultation hold.

Syntax

LONG TSPIAPI TSPI_lineSwapHold(
  DRV_REQUESTID dwRequestID,  
  HDRVCALL hdActiveCall,  
  HDRVCALL hdHeldCall 
);

Parameters

  • dwRequestID
    Identifier of the asynchronous request.
  • hdActiveCall
    Handle to the call to be swapped with the call on consultation hold. The call state of hdActiveCall can be connected.
  • hdHeldCall
    Handle to the consultation call. The call state of hdHeldCall can be onHoldPendingTransfer, onHoldPendingConference, or onHold.

Return Value

Returns dwRequestID, or an error number if an error occurs. The lResult actual parameter of the corresponding ASYNC_COMPLETION is zero if the function succeeds, or an error number if an error occurs. The following table shows the return values for this method.

Value

Description

LINEERR_INVALCALLHANDLE

The handle to the call is invalid.

LINEERR_OPERATIONUNAVAIL

The operation is unavailable.

LINEERR_INVALCALLSTATE

The call state is invalid.

LINEERR_OPERATIONFAILED

The operation failed.

LINEERR_NOMEM

Not enough memory is available.

LINEERR_RESOURCEUNAVAIL

The resource is unavailable.

Remarks

The service provider must send LINE_CALLSTATE messages for the call transitions.

Requirements

Header

tspi.h

Library

CellTSP.dll

See Also

Reference

TSPI Line Device Functions
TSPI_lineSetupConference
TSPI_lineSetupTransfer