Platform SDK: TAPI

ITBasicCallControl::HandoffDirect

Hands off the call to another application. This indicates that the application no longer requires ownership of the call.

HRESULT HandoffDirect(
  BSTR pApplicationName
);

Parameters

pApplicationName: [in] Pointer to BSTR containing the specific application name to hand off call to. Can be full path name or executable name.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
E_POINTER	The pApplicationName parameter is not a valid pointer.

Remarks

If TAPI fails to hand off the call, TAPI will call Disconnect.

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

Requirements

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

ITBasicCallControl::HandoffDirect

Parameters

Return Values

Remarks

Requirements

See Also