Platform SDK: TAPI

ITBasicCallControl::ParkIndirect

Parks the call and returns the parked address.

HRESULT ParkIndirect(
  BSTR *ppNonDirAddress
);

Parameters

ppNonDirAddress
[out, retval] Pointer to a BSTR representation of the address where the call was parked.

Return Values

Value Meaning
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.0 DLL timed it out. The timeout interval is two minutes.

Remarks

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

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

See Also

ITBasicCallControl, Call Object, linePark