TSPI_providerInstall函式 (tspi.h)

TSPI_providerInstall函式已過時。 TAPI 1.4 版或更早版本的服務提供者可以實作此 TSPI 函式。 TAPI 2.0 版或更新版本的 TSP 會實 作 TUISPI_providerInstall。

TSPI_providerInstall函式會將提供者的任何其他「片段」安裝到正確的目錄中 (，或至少確認其存在) 、設定其線路和手機的提供者登錄專案，以及建立服務提供者所需的任何其他專案。 從電話語音 控制台 公用程式呼叫， (在按下 [新增] 按鈕時，於 1.4 版和更早版本中提供 Windows Telephony) 。

語法

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

參數

hwndOwner

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

dwPermanentProviderID

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

傳回值

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

LINEERR_OPERATIONFAILED、LINEERR_INIFILECORRUPT、LINEERR_NOMEM LINEERR_INVALPARAM。

備註

此函式會在登錄的 [Providers] 區段中的專案完成服務提供者所需的其他部分安裝。 如果服務提供者在登錄中需要任何其他私用定義專案才能正常運作，則也必須安裝它們。 安裝此區段及其專案的典型方法是呼叫 TSPI_providerConfig。

此函式必須讓系統保持一致狀態。 它應該執行到完成，不允許使用者在部分完成時中止安裝。 如果安裝失敗，提供者必須負責「備份」完成的工作並傳回錯誤。 這可能表示在安裝開始之前，預先掃描以確認可以完成安裝。

在服務提供者安裝期間，只會呼叫此函式一次，直到呼叫 TSPI_providerRemove為止。 它必須在任何其他 TSPI 定義函式之前呼叫。

1.4 版和更早版本中 Windows Telephony 提供的 Telephony 控制台 公用程式會呼叫此函式， (符合外部序列需求，如叫用 “add” 命令時) 這裡所述。 它不會針對 「add」 命令呼叫 TSPI_providerConfig 。

TAPI 層級沒有對應的函式。 在該層級，應用程式預期已安裝服務提供者。 執行中的應用程式會透過LINE_LINEDEVSTATE或PHONE_STATE訊息中的LINEDEVSTATE_REINIT或PHONESTATE_REINIT值來通知動態重新設定。

規格需求

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

另請參閱

LINE_LINEDEVSTATE

PHONE_STATE

TSPI_providerConfig

TSPI_providerInit

TSPI_providerRemove

TSPI_providerShutdown