lineClose 函式 (tapi.h)

lineClose 函式會關閉指定的開啟行裝置。

語法

LONG lineClose(
  HLINE hLine
);

hLine

要關閉之開啟行裝置的句柄。成功關閉行之後，這個句柄就不再有效。

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED LINEERR_OPERATIONUNAVAIL。

如果應用程式在開啟的行上仍然有作用中的呼叫時呼叫 lineClose ，則會撤銷這些呼叫的應用程式擁有權。如果應用程式是這些呼叫的唯一擁有者，也會卸除呼叫。應用程式在關閉這一行之前明確放棄擁有權和/或卸除這些呼叫，是讓應用程式在開啟的行上處置其擁有的呼叫是很好的程序設計做法。

如果成功關閉該行，則會將LINE_LINEDEVSTATE 訊息傳送至監視開啟/關閉變更行狀態的所有應用程式。未處理的異步回復會隱藏。

服務提供者可能會發現強制從已開啟該行的應用程式回收線路裝置很有用或必要。這很適合用來防止應用程式過度佔用線路裝置。如果發生這種情況，LINE_CLOSE訊息會傳送至應用程式，並指定已關閉之裝置的行句柄。

lineOpen 函式會將資源配置給叫用的應用程式，如果資源無法使用，則應用程式可以避免開啟一行。因此，僅偶爾使用線路裝置 (的應用程式，例如進行撥出呼叫) 應該關閉該行以釋放資源，並允許其他應用程式開啟該行。