ITBasicCallControl::HandoffDirect method (tapi3if.h)
The HandoffDirect method hands off the call to another application. This indicates that the application no longer requires ownership of the call.
HRESULT HandoffDirect( BSTR pApplicationName );
Pointer to BSTR containing the specific application name to hand off call to. Can be full path name or executable name.
This method can return one of these values.
||Insufficient memory exists to perform the operation.|
||The pApplicationName parameter is not a valid pointer.|
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 the receiving application has not opened the line for the media types involved in the call, the handoff will fail. If TAPI fails to hand off the call, TAPI will call Disconnect.
|Header||tapi3if.h (include Tapi3.h)|