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 |