TUISPI_providerInstall函式 (tspi.h)
TUISPI_providerInstall函式的實作是服務提供者將提供者的任何其他「片段」安裝到正確的目錄 (,或至少確認其存在) ,並設定提供者所需的登錄專案。 此函式讓 2.0 版和更新版本中 TSPI_providerInstall 函式已過時 (1.4 版和更早版本) 。
如果服務提供者要求登錄中的任何私用定義專案才能正常運作,則必須在此時安裝這些專案。
實作是選擇性的。
語法
LONG TSPIAPI TUISPI_providerInstall(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
HWND hwndOwner,
DWORD dwPermanentProviderID
);
參數
lpfnUIDLLCallback
UI DLL 可以呼叫的函式指標,以與服務提供者 DLL 通訊,以取得顯示對話方塊所需的資訊。
hwndOwner
函式可在其中建立安裝期間所需的任何對話框視窗的父視窗句柄。
dwPermanentProviderID
服務提供者的永久提供者標識碼。
傳回值
如果函式成功或發生錯誤,則傳回零。 可能的傳回值如下所示:
LINEERR_OPERATIONFAILED、LINEERR_INIFILECORRUPT、LINEERR_NOMEM。 LINEERR_INVALPARAM。
備註
此函式必須讓系統保持一致狀態。 它應該會執行至完成,不允許使用者在完成安裝時中止安裝。 如果安裝失敗,提供者必須負責「退出」完成的工作並傳回錯誤。 這可能表示在安裝開始之前,預先掃描以確認是否可能完成安裝。
在服務提供者安裝期間,可以多次叫用此函式,直到呼叫 TUISPI_providerRemove為止。 不過,如果服務提供者不需要或支援提供者的多個實例,則會傳回 LINEERR_常 數LINEERR_NOMULTIPLEINSTANCE。
TAPI 層級的對應函式是 lineAddProvider。 LINE_CREATE訊息會通知應用程式正在執行動態重新設定。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tspi.h |