共用方式為

TSPI_lineNegotiateExtVersion函式 (tspi.h)

  • 發行項

根據可能的擴充功能版本範圍， TSPI_lineNegotiateExtVersion 函式會傳回服務提供者可為此裝置操作的最高擴充版本號碼。

語法

LONG TSPIAPI TSPI_lineNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

參數

dwDeviceID

識別要執行介面版本交涉的行裝置。 INITIALIZE_NEGOTIATION 值不能 用於此函式。

dwTSPIVersion

已使用 TSPI_lineNegotiateTSPIVersion交涉此裝置的介面版本號碼。 此函式會根據這個版本層級的介面規格運作。

dwLowVersion

TAPI 或其用戶端應用程式可以運作的最低擴充功能版本號碼。 最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。 呼叫此函式時，TAPI 不會驗證此參數。

dwHighVersion

TAPI 或其用戶端應用程式可以運作的最高擴充功能版本號碼。 最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。 呼叫此函式時，TAPI 不會驗證此參數。

lpdwExtVersion

DWORD的指標。 從此函式成功傳回時，服務提供者會在呼叫者要求的範圍內，填入此位置的最高延伸模組版本號碼，而服務提供者可以在該範圍內運作。 最重要的 WORD 是主要版本號碼，而最小有效 WORD 是次要版本號碼。 如果要求的範圍沒有與服務提供者支援的範圍重迭，函式會傳回LINEERR_INCOMPATIBLEEXTVERSION。

傳回值

如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONFAILED、LINEERR_NODRIVER、LINEERR_RESOURCEUNAVAIL LINEERR_NOMEM。

備註

此函式可以在 TAPI 開啟裝置之前或之後呼叫。 如果裝置目前已開啟且已選取擴充功能版本，則函式會在要求的範圍內提供該版本號碼。 如果選取的版本號碼超出要求的範圍，函式會傳回LINEERR_INCOMPATIBLEEXTVERSION。

需求

   
目標平台 Windows
標頭 tspi.h

另請參閱

INITIALIZE_NEGOTIATION

TSPI_lineNegotiateTSPIVersion