phoneNegotiateExtVersion 函数 (tapi.h)

项目
08/26/2023

phoneNegotiateExtVersion 函数允许应用程序协商用于指定手机设备的扩展版本。如果应用程序不支持扩展，则无需调用此操作。

语法

LONG phoneNegotiateExtVersion(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  DWORD     dwAPIVersion,
  DWORD     dwExtLowVersion,
  DWORD     dwExtHighVersion,
  LPDWORD   lpdwExtVersion
);

参数

hPhoneApp

使用 TAPI 注册应用程序的句柄。

dwDeviceID

要查询的电话设备的标识符。

dwAPIVersion

使用 phoneNegotiateAPIVersion 为指定电话设备协商的 API 版本号。

dwExtLowVersion

应用程序符合的 phoneNegotiateAPIVersion 返回的扩展标识符的最新扩展版本。高序字是主版本号;低序字是次要版本号。

dwExtHighVersion

应用程序符合的 phoneNegotiateAPIVersion 返回的扩展标识符的最新扩展版本。高序字是主版本号;低序字是次要版本号。

lpdwExtVersion

指向 DWORD 的指针，其中返回协商的扩展版本号。如果协商成功，则此数字在 dwExtLowVersion 到 dwExtHighVersion 的范围内。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

PHONEERR_INVALAPPHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_BADDEVICEID、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NODRIVER、PHONEERR_NOMEM、PHONEERR_INCOMPATIBLEAPIVERSION、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INCOMPATIBLEEXTVERSION、PHONEERR_UNINITIALIZED、PHONEERR_INVALPOINTER、PHONEERR_NODEVICE。