ITBasicCallControl::HandoffIndirect method (tapi3if.h)
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 |
|---|---|
|
Method succeeded. |
|
The lMediaType parameter is not valid. |
|
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 |