TSPI_providerShutdown 函数 (tspi.h)

TSPI_providerShutdown 函数关闭服务提供程序。 服务提供商终止正在进行的任何活动,并释放已分配的任何资源。

语法

LONG TSPIAPI TSPI_providerShutdown(
  DWORD dwTSPIVersion,
  DWORD dwPermanentProviderID
);

参数

dwTSPIVersion

此函数必须在其下运行的 TSPI 定义的版本。 调用方可以将 TSPI_lineNegotiateTSPIVersionTSPI_phoneNegotiateTSPIVersion 与特殊的 dwDeviceIDINITIALIZE_NEGOTIATION 一起使用,以协商保证服务提供商可接受的版本。

dwPermanentProviderID

此参数允许服务提供程序确定在多个可能的服务提供程序实例中关闭哪个实例。 参数的值与 在 TSPI_providerInit 中传入同名参数的值相同。

返回值

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM。

注解

对此函数的最终配对调用必须是对任何以 TSPI_lineTSPI_phone 作为前缀的 TSPI 函数的最后一次调用,而不是 TSPI_lineNegotiateTSPIVersionTSPI_phoneNegotiateTSPIVersion。 调用方负责确保这一点。

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

TAPI 中没有直接对应的函数。 在 TAPI 中,可以使用“应用程序句柄”参数来标识要操作的实例的多个不同使用情况实例。 在 TSPI 中,接口体系结构仅支持每个不同服务提供程序的单个使用实例。

要求

   
目标平台 Windows
标头 tspi.h

另请参阅

TSPI_lineNegotiateTSPIVersion

TSPI_phoneNegotiateTSPIVersion

TSPI_providerInit