ITBasicCallControl::ParkDirect method (tapi3if.h)

The ParkDirect method parks the call at a specified address.

Syntax

HRESULT ParkDirect(
  BSTR pParkAddress
);

Parameters

pParkAddress

Pointer to BSTR containing the address where the call is to be parked.

Return value

This method can return one of these values.

Return code Description
S_OK
Method succeeded.
E_POINTER
The pParkAddress parameter is not a valid pointer.
E_FAIL
Park is not supported.
E_INVALIDARG
The pParkAddress parameter is not valid.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.
TAPI_E_TIMEOUT
The operation failed because the TAPI 3 DLL timed it out. The timeout interval is two minutes.

Remarks

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.

With directed park, the application determines the address at which it wants to park the call. With ParkInDirect, the switch determines the address and provides this to the application. In either case, a parked call can be unparked by specifying this address.

The parked call enters the disconnected state after it has been successfully parked.

Some switches can remind the user after a call has been parked for some long amount of time. The application sees an offering call with a call reason set to reminder.

The application must use SysAllocString to allocate memory for the pParkAddress parameter and use SysFreeString to free the memory when the variable is no longer needed.

Requirements

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

See also

Call Object

ITBasicCallControl

Park overview

linePark