TUISPI_providerConfig函式 (tspi.h)

TUISPI_providerConfig函式會實作必須在呼叫應用程式內容中執行的UI元素。 此函式讓 2.0 版和更新版本中 TSPI_providerConfig 函式已過時 (1.4 版和更早版本) 。

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

實作是選擇性的。

語法

LONG TSPIAPI TUISPI_providerConfig(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

參數

lpfnUIDLLCallback

UI DLL 可以呼叫的函式指標，以與服務提供者 DLL 通訊，以取得顯示對話方塊所需的資訊，以及將更新的組態傳送給服務提供者。

hwndOwner

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

dwPermanentProviderID

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

傳回值

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

LINEERR_OPERATIONFAILED，LINEERR_NOMEM。

備註

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

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

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

規格需求

另請參閱

TUISPI_lineConfigDialog

TUISPI_phoneConfigDialog

TUISPI_providerInstall

TUISPI_providerRemove