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

另请参阅

TSPI_phoneNegotiateExtVersion