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,允許在安裝特定線路或電話的參數之後進行設定。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tspi.h |