TSPI_phoneNegotiateExtVersion 函数 (tspi.h)
给定可能的扩展版本范围, TSPI_phoneNegotiateExtVersion 函数返回服务提供商为此设备操作时可以使用的最高扩展版本号。
语法
LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
参数
dwDeviceID
标识要为其执行接口版本协商的电话设备。
dwTSPIVersion
指定使用 TSPI_phoneNegotiateTSPIVersion 为此设备协商的接口版本号。 此函数根据此版本级别的接口规范运行。
dwLowVersion
TAPI 或其客户端应用程序可以运行的最低扩展版本号。 最重要的 WORD 是主版本号,最低有效 WORD 是次要版本号。
dwHighVersion
TAPI 或其客户端应用程序可以运行的最高扩展版本号。 最重要的 WORD 是主版本号,最低有效 WORD 是次要版本号。
lpdwExtVersion
指向 DWORD 的指针。 从此函数成功返回后,服务提供商会在调用方请求的范围内用最高分机版本号填充此位置,服务提供商可以在该范围内进行操作。 最重要的 WORD 是主版本号,最低有效 WORD 是次要版本号。 如果请求的范围不与服务提供程序支持的范围重叠,则函数将返回PHONEERR_INCOMPATIBLEEXTVERSION。
返回值
如果函数成功,则返回零;如果发生错误,则返回错误号。 可能的返回值如下所示:
PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_OPERATIONFAILED、PHONEERR_NODRIVER、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOMEM。
注解
可以在 TAPI 打开设备之前或之后调用此函数。 如果设备当前处于打开状态,并且已选择扩展版本,则函数应返回该版本号(如果该版本号在请求的范围内)。 如果所选版本号超出请求的范围,则函数返回PHONEERR_INCOMPATIBLEEXTVERSION。
要求
目标平台 | Windows |
标头 | tspi.h |