lineNegotiateAPIVersion 函数 (tapi.h)

项目
03/02/2024

lineNegotiateAPIVersion 函数允许应用程序协商要使用的 API 版本。

语法

LONG lineNegotiateAPIVersion(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAPILowVersion,
  DWORD             dwAPIHighVersion,
  LPDWORD           lpdwAPIVersion,
  LPLINEEXTENSIONID lpExtensionID
);

参数

hLineApp

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

dwDeviceID

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

dwAPILowVersion

应用程序符合的最早 TAPI 版本。高序字是主版本号;低序字是次要版本号。

dwAPIHighVersion

应用程序符合的最新 TAPI 版本。高序字是主版本号;低序字是次要版本号。

lpdwAPIVersion

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

lpExtensionID

指向 LINEEXTENSIONID 类型的结构的指针。如果指定 dwDeviceID 的服务提供程序支持特定于提供程序的扩展，则在成功协商后，此结构将填充这些扩展的扩展标识符。如果行不提供任何扩展，则此结构包含所有零。如果应用程序不使用扩展，则可以忽略返回的参数。

返回值

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

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