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 函数将资源分配给调用的应用程序，如果资源不可用，则可以阻止应用程序打开一行。因此，仅偶尔使用线路设备（例如进行传出呼叫）的应用程序应关闭该行以释放资源并允许其他应用程序打开该行。