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