Platform SDK: TAPI

ITBasicCallControl::SwapHold

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
);

Parameters

pCall: [in] Call, currently on hold, that is to be made active.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_FAIL	This operation is not supported.
E_POINTER	The pCall parameter is not a valid pointer.
E_INVALIDARG	The pCall parameter does not describe a currently existing call.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
E_OPERATIONFAILED	The operation failed.
TAPI_E_TIMEOUT	The operation failed because the TAPI 3.0 DLL timed it out. The timeout interval is two minutes.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

ITBasicCallControl::SwapHold

Parameters

Return Values

Requirements

See Also