Share via

TSPI_lineSwapHold

  • Article

The TSPI_lineSwapHold function swaps the specified active call with the specified call on consultation hold.

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

Parameters

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

Return Values

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. Possible return values are as follows:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Remarks

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

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 3.0 and later Tapicomn.h   Coredll.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

TSPI_lineSetupConference, TSPI_lineSetupTransfer

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.