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：：StartSubStream。

如果接收應用程式尚未開啟呼叫中涉及的媒體類型行，則交接將會失敗。如果 TAPI 無法接聽通話，TAPI 會呼叫 Disconnect。

應用程式必須使用 SysAllocString 為 pApplicationName 參數配置記憶體，並使用 SysFreeString 在不再需要變數時釋放記憶體。