HandoffDirect 方法會將呼叫交給另一個應用程式。 這表示應用程式不再需要呼叫的擁有權。
語法
HRESULT HandoffDirect(
[in] BSTR pApplicationName
);
參數
[in] pApplicationName
BSTR 的指標，其中包含要交接呼叫的特定應用程式名稱。 可以是完整路徑名稱或可執行檔名稱。
傳回值
這個方法可以傳回其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
方法成功。 |
|
記憶體不足，無法執行作業。 |
|
pApplicationName 參數不是有效的指標。 |
備註
某些服務提供者在串流作用中時不支援這項作業。 在作業完成之後，應用程式可能需要呼叫 ITStream：：StopStream 或 ITSubStream：：StopSubStream，再呼叫 ITStream：：StartStream：：StartSubStream。
如果接收應用程式尚未開啟呼叫中涉及的媒體類型行，則交接將會失敗。 如果 TAPI 無法接聽通話，TAPI 會呼叫 Disconnect。
應用程式必須使用 SysAllocString 為 pApplicationName 參數配置記憶體，並使用 SysFreeString 在不再需要變數時釋放記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi3if.h (包括 Tapi3.h) |
| 程式庫 | Uuid.lib |
| Dll | Tapi3.dll |