lineRemoveProvider 函式 (tapi.h)

發行項
03/02/2024

lineRemoveProvider 函式會從電話語音系統移除現有的電話語音服務提供者。

語法

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

參數

dwPermanentProviderID

要移除之服務提供者的永久提供者標識碼。

hwndOwner

處理視窗，其中任何需要顯示為移除程式一部分的對話框 (，例如，服務提供者的 TSPI_providerRemove函式) 會附加確認對話方塊。可以是 NULL 值，表示函式期間建立的任何視窗都應該沒有擁有者視窗。

傳回值

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

LINEERR_INIFILECORRUPT、LINEERR_NOMEM、LINEERR_INVALPARAM LINEERR_OPERATIONFAILED。

備註

如果對TSPI_providerRemove 的呼叫成功，且電話語音系統在當時處於作用中狀態，TAPI 會在服務提供者上呼叫 lineShutdown 和/或 phoneShutdown (，視裝置類型為作用中) 而定。在向) 使用者驗證之後，應用程式仍會強制關閉LINE_CLOSE或PHONE_CLOSE訊息， (服務提供者最好在TSPI_providerRemove一部分發出這些訊息。先前受該提供者控制下的裝置會標示為「無法使用」，讓應用程式未來嘗試依裝置標識碼參考這些裝置會導致LINEERR_NODRIVER。