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