ITBasicCallControl::Unpark method (tapi3if.h)

Article
02/22/2024

The Unpark method gets the call from park.

Syntax

HRESULT Unpark();

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method succeeded.
E_FAIL	The park operation is not supported.
TAPI_E_INVALCALLSTATE	Call state must be CS_IDLE.
TAPI_E_TIMEOUT	The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

Remarks

To unpark a call, CreateCall must be called using as the destination address the current parked location of the call. See the example below.

Examples

// Note: the parameters used in this call are obtained from elsewhere in the code.  

HRESULT hr = pAddress-&gt;CreateCall( bstrAddressToCall, 
                           dwAddressType, 
                           dwMediaTypes, 
                           &amp;pBasicCall 
                           ); 
// If ( hr != S_OK ) process the error here. 

// Select appropriate terminals for call, and then call: 
pBasicCall -&gt;Unpark();

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)
Library	Uuid.lib
DLL	Tapi3.dll