ITBasicCallControl::Unpark method (tapi3if.h)

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->CreateCall( bstrAddressToCall,
                           dwAddressType,
                           dwMediaTypes,
                           &pBasicCall
                           );
// If ( hr != S_OK ) process the error here.

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

Requirements

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

See also

Call Object

ITAddress::CreateCall

ITBasicCallControl

Park overview

ParkDirect

ParkIndirect

lineUnpark