通过

TSPI_phoneClose 函数 (tspi.h)

  • 项目

TSPI_phoneClose函数在完成或中止设备上所有未完成的异步操作后关闭指定的打开手机设备。

语法

LONG TSPIAPI TSPI_phoneClose(
  HDRVPHONE hdPhone
);

参数

hdPhone

服务提供商要关闭的电话的不透明句柄。 成功关闭手机后，此句柄不再有效。

返回值

如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_RESOURCEUNAVAIL。

注解

服务提供商必须报告每个异步操作的完成情况。 如果对存在未完成异步操作的电话调用此过程，则应在此过程返回之前报告操作完成并显示相应的结果或错误代码。 通常，TAPI 会按顺序等待这些操作完成。 但是，服务提供商应准备好在“中止”或“紧急关闭”情况下处理 对TSPI_phoneClose 的早期调用。

此过程返回后，服务提供商必须不报告手机上的进一步事件。 服务提供商对电话的不透明句柄变为无效。

服务提供商必须在手机打开时放弃它保留的不可共享资源。 例如，关闭通过 comm 端口和调制解调器访问的手机应会导致关闭 comm 端口，使其可供其他应用程序使用。

此函数应始终成功，除非在特殊情况下。 大多数调用方可能会忽略返回代码，因为他们无法补偿发生的任何错误。 对于开发诊断目的，指定的返回值比任何其他值更具有建议性。

要求

   
目标平台 Windows
标头 tspi.h

另请参阅

PHONE_CLOSE