lineSwapHold (Windows CE 5.0)
This function swaps the specified active call with the specified call on consultation hold.
LONG WINAPI lineSwapHold(HCALL hActiveCall,HCALL hHeldCall);
Parameters
- hActiveCall
Handle to the active call. The application must be an owner of the call. The call state of hActiveCall must be connected. - hHeldCall
Handle to the consultation call. The application must be an owner of the call. The call state of hHeldCall can be onHoldPendingTransfer, onHoldPendingConference, or onHold.
Return Values
Returns a positive request identifier if the function is completed asynchronously, or a negative error number if an error occurs. The dwParam2 parameter of the corresponding LINE_REPLY message is zero if the function succeeds or it is a negative error number if an error occurs. The following table shows the return values for this function.
| Value | Description |
|---|---|
| LINEERR_INVALCALLHANDLE | A call handle 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 resources are unavailable. |
| LINEERR_NOTOWNER | The application is not an owner of this call. |
| LINEERR_UNINITIALIZED | A parameter is uninitialized. |
Remarks
Swapping the active call with the call on consultation hold allows the application to alternate or toggle between these two calls. This is typical in call waiting.
Note This function is for TAPI version 2.0 and later.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.
See Also
Send Feedback on this topic to the authors