ITBasicCallControl::ParkIndirect method (tapi3if.h)

Article
02/22/2024

The ParkIndirect method parks the call and returns the parked address.

Syntax

HRESULT ParkIndirect(
  [out] BSTR *ppNonDirAddress
);

Parameters

[out] ppNonDirAddress

Pointer to a BSTR representation of the address where the call was parked.

Return value

This method can return one of these values.

Return code	Description
S_OK	Method succeeded.
E_POINTER	The ppNonDirAddress parameter is not a valid pointer.
E_FAIL	Park is not supported.
E_INVALIDARG	The ppNonDirAddress 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 ParkDirect, the application determines the address at which it wants to park the call. With nondirected park, 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 SysFreeString to free the memory allocated for the ppNonDirAddress parameter.

Requirements

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