ITBasicCallControl::SwapHold method (tapi3if.h)
The SwapHold method swaps the call (which is active) with the specified call on hold.
Swapping the active call with the call on consultation hold allows the application to toggle between these two calls. This is typical in call waiting.
HRESULT SwapHold( ITBasicCallControl *pCall );
Call, currently on hold, that is to be made active.
This method can return one of these values.
||This operation is not supported.|
||The pCall parameter is not a valid pointer.|
||The pCall parameter does not describe a currently existing call.|
||Insufficient memory exists to perform the operation.|
||The operation failed.|
||The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes.|
Some service providers do not support this operation while streaming is active. The application may need to call ITStream::StopStream or ITSubStream::StopSubStream prior to the operation and ITStream::StartStream or ITSubStream::StartSubStream following completion of the operation.
|Header||tapi3if.h (include Tapi3.h)|