TSPI_phoneSelectExtVersion 函数 (tspi.h)
TSPI_phoneSelectExtVersion函数为指示的电话设备选择指定的扩展版本。 后续请求根据该扩展版本运行。
语法
LONG TSPIAPI TSPI_phoneSelectExtVersion(
HDRVPHONE hdPhone,
DWORD dwExtVersion
);
参数
hdPhone
要为其选择分机版本的手机的句柄。
dwExtVersion
要选择的扩展版本。 此版本号是使用 TSPI_phoneNegotiateExtVersion 协商的。 最重要的 WORD 是主版本号,最低有效 WORD 是次要版本号。 使用 零的 dwExtVersion 调用此函数将取消当前所选内容。
返回值
如果函数成功,则返回零;如果发生错误,则返回错误号。 可能的返回值如下所示:
PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_RESOURCEUNAVAIL。
注解
此函数选择指示的扩展版本。 尽管指示的版本号可能已成功协商,但在此期间可能选择了不同的扩展版本,在这种情况下,此函数 (返回PHONEERR_INCOMPATIBLEEXTVERSION) 失败。
选择扩展版本后,手机上的后续操作会根据该扩展版本的行为。 后续尝试协商扩展版本会严格报告所选版本,如果请求的范围不包括所选版本) ,则为零 (。 使用特殊扩展版本 0 调用此过程将取消当前选择。 设备再次能够支持其完整的扩展版本号范围。
TSPI_phoneSelectExtVersion 通常在两种情况下调用: (1) 应用程序请求打开电话,应用程序请求使用特定的扩展版本,并且当前未选择任何扩展版本;或 (2) 最后一个使用特定扩展版本的应用程序关闭手机,并且可以取消选择扩展版本。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |