lineSwapHold
The lineSwapHold
function swaps the specified active call with the specified call on
consultation hold.
LONG lineSwapHold(
|
HCALL hActiveCall, |
|
|
HCALL hHeldCall |
|
|
); |
|
Parameters
hActiveCall
The handle to
the active call. The application must be an owner of the call. The call state
of hActiveCall must be connected.
hHeldCall
The handle to
the consultation call. The application must be an owner of the call. The call
state of hHeldCall can be onHoldPendingTransfer,
onHoldPendingConference, onHold .
Return Values
Returns a
positive request ID if the function will be completed asynchronously, or a
negative error number if an error has occurred. The dwParam2 parameter
of the corresponding LINE_REPLY
message is zero if the function is successful or it is a negative error number
if an error has occurred. Possible return values are:
LINEERR_INVALCALLHANDLE,
LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED,
LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER,
LINEERR_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.
See Also