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 |