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 |