itBasicCallControl：：HandoffDirect 方法 (tapi3if.h)

HandoffDirect 方法将调用移交给另一个应用程序。这表明应用程序不再需要调用的所有权。

语法

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

[in] pApplicationName

指向 BSTR 的指针，其中包含要将其调用移交给的特定应用程序名称。可以是完整路径名称或可执行文件名称。

此方法可以返回其中一个值。

返回代码	说明
S_OK	方法成功。
E_OUTOFMEMORY	内存不足，无法执行操作。
E_POINTER	pApplicationName 参数不是有效的指针。

当流式处理处于活动状态时，某些服务提供商不支持此操作。应用程序可能需要在操作之前调用 ITStream：：StopStream 或 ITSubStream：：StopSubStream ，并在操作完成后调用 ITStream：：StartStream 或 ITSubStream：：StartSubStream 。

如果接收应用程序尚未打开呼叫中涉及的媒体类型的线路，则切换将失败。如果 TAPI 无法接听呼叫，TAPI 将调用 Disconnect。

应用程序必须使用 SysAllocString 为 pApplicationName 参数分配内存，并在不再需要变量时使用 SysFreeString 释放内存。