共用方式為


TSPI_lineCloseCall函式 (tspi.h)

TSPI_lineCloseCall函式在呼叫完成或中止所有未完成的異步操作之後,會解除分配呼叫。

語法

LONG TSPIAPI TSPI_lineCloseCall(
  HDRVCALL hdCall
);

參數

hdCall

要關閉之呼叫的服務提供者句柄。 成功關閉呼叫之後,此句柄就不再有效。 呼叫狀態可以是任何狀態。

傳回值

如果函式成功或發生錯誤,則傳回零。 可能的傳回值如下所示:

LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL。

備註

服務提供者必須報告異步操作的完成。 如果 呼叫 TSPI_lineCloseCall 呼叫有未完成異步操作的呼叫,則此程式傳回之前,應該先以適當的結果或錯誤碼回報作業。 此程式傳回之後,服務提供者必須在呼叫上回報任何進一步的事件。 該行的服務提供者句柄,而該行上的呼叫會變成「無效」。

如果服務提供者同步從呼叫 TSPI_lineMakeCall 函式傳回錯誤,TAPI 不會呼叫 TSPI_lineCloseCall 。 但是,如果服務提供者從由 TSPI_lineMakeCall 起始的異步操作傳回錯誤,TAPI 就會呼叫 TSPI_lineCloseCall

如果在 TSPI_lineCloseCall時行上有作用中呼叫,則如果此行為是由 LINEDEVCAPS 結構中的LINEDEVCAPFLAGS_CLOSEDROP位表示,則必須卸除呼叫。

如果服務提供者可以判斷有另一個代理程式共用呼叫的控制權,例如在具有個別的電話的合作物件行狀況中,服務提供者只要控制呼叫傳遞至另一個代理程式,而不是強制卸除它。

此函式應一律會成功,但在某些情況下除外。 大部分的呼叫端可能會忽略傳回碼,因為它們無法補償發生的任何錯誤。 指定的傳回值比任何其他專案更適用於開發診斷用途的諮詢。

當最後一個具有此呼叫句柄的應用程式執行 lineDeallocateCall時,會呼叫此函式。

規格需求

需求
目標平台 Windows
標頭 tspi.h

另請參閱

LINEDEVCAPS

TSPI_lineMakeCall