lineNegotiateAPIVersion 函式 (tapi.h)

發行項
03/13/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。

備註

使用 lineInitializeEx 來判斷系統中存在的線路裝置數目。 dwDeviceID 指定的裝置標識碼會從零到一個小於存在行裝置數目的裝置標識碼。

lineNegotiateAPIVersion 函式是用來交涉要使用的 API 版本號碼。它也會擷取行裝置所支援的延伸模組標識碼，並在不支援任何延伸模組時傳回零。如果應用程式想要使用傳回延伸模組標識碼所定義的延伸模組，它必須呼叫 lineNegotiateExtVersion 來交涉要使用的擴充功能版本。

交涉的 API 版本號碼是 TAPI 可以運作的。如果版本範圍不重疊，則應用程式和 API 或服務提供者版本不相容，並傳回錯誤。