共用方式為

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

另請參閱

LINE_CREATE

PHONE_STATE

TSPI_providerInit

TSPI_providerShutdown

TUISPI_providerConfig

TUISPI_providerRemove