lineNegotiateExtVersion 函式 (tapi.h)

發行項
03/02/2024

lineNegotiateExtVersion 函式可讓應用程式交涉擴充功能版本，以搭配指定的行裝置使用。如果應用程式不支援擴充功能，則不需要呼叫此作業。

語法

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

參數

hLineApp

使用 TAPI 處理應用程式的註冊。

dwDeviceID

要查詢之線路裝置的標識碼。

dwAPIVersion

使用 lineNegotiateAPIVersion 交涉給指定行裝置的 TAPI 版本號碼。

dwExtLowVersion

應用程式符合規範之 lineNegotiateAPIVersion 所傳回之延伸模組識別碼的最早延伸模組版本。高序字是主要版本號碼;低序字是次要版本號碼。

dwExtHighVersion

應用程式符合規範之 lineNegotiateAPIVersion 所傳回之延伸模組識別碼的最新擴充功能版本。高序字是主要版本號碼;低序字是次要版本號碼。

lpdwExtVersion

變數的指標，其中包含已交涉的擴充功能版本號碼。如果交涉成功，這個數字會位於 dwExtLowVersion 與 dwExtHighVersion 之間的範圍內。

傳回值

如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。可能的傳回值為：

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