TSPI_providerShutdown函式 (tspi.h)
TSPI_providerShutdown函式會關閉服務提供者。 服務提供者會終止任何進行中的活動,並釋放它配置的任何資源。
語法
LONG TSPIAPI TSPI_providerShutdown(
DWORD dwTSPIVersion,
DWORD dwPermanentProviderID
);
參數
dwTSPIVersion
此函式必須在其下運作的 TSPI 定義版本。 呼叫端可以使用 TSPI_lineNegotiateTSPIVersion 或 TSPI_phoneNegotiateTSPIVersion 搭配特殊的 dwDeviceIDINITIALIZE_NEGOTIATION ,交涉保證可接受給服務提供者的版本。
dwPermanentProviderID
此參數可讓服務提供者判斷服務提供者的多個可能實例之間要關閉的實例。 參數的值與在 TSPI_providerInit中傳遞相同名稱的參數相同。
傳回值
如果函式成功,則傳回零;如果發生錯誤,則傳回錯誤號碼。 可能的傳回值如下所示:
LINEERR_INCOMPATIBLEAPIVERSION,LINEERR_NOMEM。
備註
此函式的最後一個配對呼叫必須是前置 詞為 TSPI_line 或 TSPI_phone 以外的任何 TSPI 函式的最後一個呼叫,而不是 TSPI_lineNegotiateTSPIVersion或 TSPI_phoneNegotiateTSPIVersion。 呼叫者必須負責確保這一點。
此函式應該一律會成功,但例外狀況除外。 大部分的呼叫端可能會忽略傳回碼,因為它們無法補償發生的任何錯誤。 指定的傳回值比任何其他專案更適合用於開發診斷用途。
TAPI 中沒有直接對應的函式。 在 TAPI 中,可以使用「應用程式控制碼」參數來識別要運作之實例的多個不同使用實例。 在 TSPI 中,介面架構僅支援每個不同服務提供者的單一使用實例。
規格需求
目標平台 | Windows |
標頭 | tspi.h |