phoneNegotiateAPIVersion 函数 (tapi.h)

项目
03/05/2024

phoneNegotiateAPIVersion 允许应用程序协商要用于指定手机设备的 API 版本。

语法

LONG phoneNegotiateAPIVersion(
  HPHONEAPP          hPhoneApp,
  DWORD              dwDeviceID,
  DWORD              dwAPILowVersion,
  DWORD              dwAPIHighVersion,
  LPDWORD            lpdwAPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

参数

hPhoneApp

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

dwDeviceID

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

dwAPILowVersion

应用程序符合的最小 API 版本。高序字是主版本号，低位字是次版本号。

dwAPIHighVersion

应用程序符合的最新 API 版本。高序字是主版本号，低位字是次版本号。

lpdwAPIVersion

指向 DWORD 的指针，在该 DWORD 中将返回协商的 API 版本号。如果协商成功，则此数字在 dwAPILowVersion 到 dwAPIHighVersion 的范围内。

lpExtensionID

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

返回值

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

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