lineNegotiateExtVersion 函式 (tapi.h)

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。

備註

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

lineNegotiateAPIVersion 函式會交涉要使用的 API 版本號碼。 它也會擷取行裝置所支援的延伸模組標識碼，如果未提供任何延伸模組，則為零。 版本號碼應該針對每個版本遞增一個。 在發行版本編號中留下間距可能會導致非預期的結果。

如果應用程式想要使用傳回延伸模組標識碼所定義的延伸模組，它必須呼叫 lineNegotiateExtVersion 來交涉要使用的擴充功能版本。

交涉的擴充功能版本號碼是應用程式和服務提供者必須同時運作。 如果版本範圍沒有重疊，則應用程式和服務提供者版本不相容，並傳回錯誤。

規格需求

另請參閱

擴充電話語音服務參考

TAPI 2.2 參考概觀

lineInitializeEx

lineNegotiateAPIVersion