共用方式為


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_providerInitTSPI_providerShutdown) 之間呼叫此函式。

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

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

規格需求

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

另請參閱

TUISPI_lineConfigDialog

TUISPI_phoneConfigDialog

TUISPI_providerInstall

TUISPI_providerRemove