lineNegotiateExtVersion 函数 (tapi.h)

项目
03/02/2024

lineNegotiateExtVersion 函数允许应用程序协商要与指定线路设备一起使用的扩展版本。如果应用程序不支持扩展，则无需调用此操作。

语法

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

参数

hLineApp

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

dwDeviceID

要查询的线路设备的标识符。

dwAPIVersion

使用 lineNegotiateAPIVersion 为指定线路设备协商的 TAPI 版本号。

dwExtLowVersion

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

dwExtHighVersion

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

lpdwExtVersion

指向包含已协商的扩展版本号的变量的指针。如果协商成功，则此数字在 dwExtLowVersion 和 dwExtHighVersion 之间。

返回值

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

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NODRIVER、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_INVALAPPHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NODEVICE、LINEERR_OPERATIONUNAVAIL。