TSPI_lineClose函式 (tspi.h)

TSPI_lineClose函式會在完成或中止裝置上所有未完成的呼叫和異步操作之後，關閉指定的開啟行裝置。

語法

LONG TSPIAPI TSPI_lineClose(
  HDRVLINE hdLine
);

hdLine

要關閉之行的服務提供者句柄。成功關閉行之後，這個句柄就不再有效。

如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。可能的傳回值如下所示：

LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL。

服務提供者必須針對每個異步操作報告完成。如果針對有未處理異步操作的行呼叫 TSPI_lineClose ，此程式傳回之前會以適當的結果或錯誤碼回報作業。

在行上作用中的呼叫有類似的需求。未完成的作業必須以適當的結果或錯誤碼回報。如有需要，也必須卸除作用中呼叫，而且如果此行為是由 LINEDEVCAPS 結構中的LINEDEVCAPFLAGS_CLOSEDROP位表示。

此程式傳回之後，服務提供者必須在該行上回報任何進一步 的 htCall 或呼叫。服務提供者的行句柄，而該行上的呼叫會變成「無效」。

服務提供者必須在行開啟時放棄其保留的非可共享資源。例如，關閉透過 comm 埠存取的線路，數據機應該會關閉 comm 連接埠，讓它再次可供其他應用程式使用。

服務提供者不會發出 LINE_LINEDEVSTATE 訊息以回應此函式調用，因為該行會關閉，而且不再對其狀態變更感興趣。

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