Platform SDK: TAPI |
Parks the call at a specified address.
HRESULT ParkDirect( BSTR pParkAddress );
Value | Meaning |
---|---|
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.0 DLL timed it out. The timeout interval is two minutes. |
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.
Windows NT/2000: Requires Windows 2000.
Version: Requires TAPI 3.0 or later.
Header: Declared in Tapi3.h.
Library: Use T3iid.lib.
ITBasicCallControl, Park Overview, Call Object, linePark