ITBasicCallControl::Handoff

[This is preliminary documentation and subject to change.]

This method hands off the call to another application. This indicates that the application no longer owns the call. There are three ways to hand off a call:

• Supply the application name to hand off to (called a "directed handoff"). The pMediaType parameter should be NULL in this case. TAPI will check on whether the application is already running, and if so, will try to hand the call to it. If it is not running, TAPI will try to start the application, then hand off to it. If these both fail, TAPI will then try an undirected handoff, using the last known pMediaType.
• Supply the pMediaType of the call and have TAPI find an appropriate application. The pAppName parameter should be NULL in this case. TAPI will only look at applications that are already running.
• Supply neither the application name nor the pMediaType. In this case, both pApplicationName and pMediaType are NULL. TAPI will attempt to do an undirected handoff, based on the last known pMediaType.

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

HRESULT Handoff(
  BSTR pApplicationName,
  BSTR pMediaType
);
 

Parameters

pApplicationName

[in] Specific application name to handoff call to. Can be full path name or executable name.

pMediaType

[in] MediaType to transfer to.

Return Values

TBD