共用方式為


lineNegotiateAPIVersion 函式 (tapi.h)

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 版本號碼。 如果交涉成功,則此數字位於 dwAPILowVersiondwAPIHighVersion 之間的範圍內。

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 或服務提供者版本不相容,並傳回錯誤。

規格需求

需求
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

基本電話語音服務參考

LINEEXTENSIONID

TAPI 2.2 參考概觀

TAPI 版本控制

lineInitializeEx

lineNegotiateExtVersion