phoneNegotiateAPIVersion 函式 (tapi.h)

發行項
03/02/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 的指標，其中會傳回交涉的 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。