phoneNegotiateExtVersion 函式 (tapi.h)

發行項
03/02/2024

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。