TUISPI_providerRemove函式 (tspi.h)

發行項
08/26/2023

TUISPI_providerRemove函式會要求使用者確認刪除服務提供者。此函式會使 2.0 版和更新版本中的 TSPI_providerRemove 函式過時 (1.4 版和更早版本) 。

服務提供者必須負責移除服務提供者在 addProvider 時間新增的任何登錄專案，以及不再需要的任何其他模組和檔案。

實作是選擇性的。

語法

LONG TSPIAPI TUISPI_providerRemove(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

參數

lpfnUIDLLCallback

UI DLL 可以呼叫的函式指標，以與服務提供者 DLL 通訊，以取得顯示對話方塊所需的資訊。

hwndOwner

父視窗的控制碼，函式可以在移除期間建立任何所需的對話方塊視窗。

dwPermanentProviderID

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

傳回值

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

LINEERR_OPERATIONFAILED、LINEERR_INIFILECORRUPT、LINEERR_NOMEM LINEERR_INVALPARAM。

備註

如果服務提供者傳回成功，此函式必須保證任何服務提供者的私人定義資訊都會從登錄中移除。

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

當服務提供者在使用 (時，可以在 TSPI_providerInit 與 TSPI_providerShutdown) 之間呼叫此函式。如果發生這種情況，服務提供者應該執行適當的組合來顯示使用者對話方塊，以宣告任何衝突並確認移除、限制可透明執行的移除選項，或發出 LINE_CLOSE 和 PHONE_CLOSE 訊息，以通知 TAPI 和應用程式已強制關閉受影響的裝置以進行移除。在任何情況下，影響透過 TSPI 可見行為的任何變更，只有在服務提供者在下一個 TSPI_providerShutdown關閉時才會生效。

注意此函式不應該傳回LINEERR_INUSE或其他可能發生的錯誤，因為提供者正在使用應用程式;相反地，提供者應該直接與使用者授與此問題，然後在使用者決定中止作業時傳回LINEERR_OPERATIONFAILED。

在移除服務提供者時，只會呼叫此程式一次，直到呼叫 TUISPI_providerInstall為止。

TAPI 層級的對應函式是 lineRemoveProvider。在該層級，應用程式預期已安裝服務提供者;否則，其線路和手機不會出現在裝置識別碼的可用序列內。 LINE_CREATE訊息會通知執行動態重新設定的應用程式。