TSPI_providerConfig函式 (tspi.h)

TSPI_providerConfig函式已過時。 TAPI 1.4 版或更早版本的服務提供者可以實作此 TSPI 函式。 TAPI 2.0 版或更新版本的 TSP 會實作TUISPI_providerConfig。

TSPI_providerConfig函式會收集使用者的組態資訊。它可以使用對話框，而且此對話框可以包含與其他 API 相關聯的子對話框 (，例如 Comm/datamodem) ，以設定特定裝置。

語法

LONG TSPIAPI TSPI_providerConfig(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

hwndOwner

父視窗的句柄，函式可以在組態期間建立任何所需的對話框視窗。

dwPermanentProviderID

服務提供者的永久提供者標識碼。

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

LINEERR_OPERATIONFAILED，LINEERR_NOMEM。

當服務提供者正在使用 (時，可以在呼叫 TSPI_providerInit 和 TSPI_providerShutdown) 之間呼叫此函式。

影響透過 TSPI 顯示之行為的任何變更，只有在服務提供者在下一個TSPI_providerInit重新啟動時才會生效。

1.4 版和更早版本中 Windows Telephony 提供的 Telephony 控制台公用程式會在叫用安裝程式命令時呼叫此函式。

TAPI 層級沒有直接對應的函式。在 TAPI 中，應用程式可以存取 functions lineConfigDialog 和 phoneConfigDialog，允許在安裝特定線路或電話的參數之後進行設定。

需求	值
目標平台	Windows
標頭	tspi.h