TSPI_lineNegotiateExtVersion函数 (tspi.h)

  • 项目

鉴于可能的扩展版本范围， TSPI_lineNegotiateExtVersion 函数返回服务提供商可为此设备操作的最高扩展版本号。

语法

LONG TSPIAPI TSPI_lineNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

参数

dwDeviceID

标识要为其执行接口版本协商的线路设备。 INITIALIZE_NEGOTIATION值不能用于此函数。

dwTSPIVersion

已使用 TSPI_lineNegotiateTSPIVersion 为此设备协商的接口版本号。 此函数根据此版本级别的接口规范运行。

dwLowVersion

TAPI 或其客户端应用程序可以运行的最低扩展版本号。 最重要的 WORD 是主版本号，最小有效 WORD 是次要版本号。 调用此函数时，TAPI 不会验证此参数。

dwHighVersion

TAPI 或其客户端应用程序可以运行的最高扩展版本号。 最重要的 WORD 是主版本号，最小有效 WORD 是次要版本号。 调用此函数时，TAPI 不会验证此参数。

lpdwExtVersion

指向 DWORD 的指针。 从此函数成功返回后，服务提供商会在调用方请求的范围内用最高分机版本号填充此位置，服务提供商可以在该范围内进行操作。 最重要的 WORD 是主版本号，最小有效 WORD 是次要版本号。 如果请求的范围不与服务提供商支持的范围重叠，则函数将返回LINEERR_INCOMPATIBLEEXTVERSION。

返回值

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NODRIVER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM。

注解

可以在 TAPI 打开设备之前或之后调用此函数。 如果设备当前处于打开状态，并且已选择扩展版本，则函数会提供该版本号（如果该版本号在请求的范围内）。 如果所选版本号超出请求的范围，则函数将返回LINEERR_INCOMPATIBLEEXTVERSION。

要求

   
目标平台 Windows
标头 tspi.h

另请参阅

INITIALIZE_NEGOTIATION

TSPI_lineNegotiateTSPIVersion