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 或线路上的调用。 服务提供商对线路的句柄和线路上的调用将变为“无效”。
在线路打开时，服务提供商必须放弃它保留的不可共享资源。 例如，关闭通过通信端口和调制解调器访问的线路应会导致关闭通信端口，使其再次可供其他应用程序使用。
服务提供商不会发出 LINE_LINEDEVSTATE 消息以响应此函数调用，因为该行关闭，并且不再对其状态更改有任何兴趣。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |