ITBasicCallControl::HandoffIndirect method (tapi3if.h)

Article
02/22/2024

The HandoffIndirect method hands off the call to another application based on the media type of the call. If multiple applications have registered as able to handle the types involved, TAPI will hand off to the highest-priority application, which is usually the one that registered first.

This indicates that the application no longer requires ownership of the call.

Syntax

HRESULT HandoffIndirect(
  [in] long lMediaType
);

Parameters

[in] lMediaType

Media type to transfer to.

Return value

This method can return one of these values.

Return code	Description
S_OK	Method succeeded.
E_INVALIDARG	The lMediaType parameter is not valid.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

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.

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

Requirements

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