IUpdateInstaller：：BeginUninstall 方法 (wuapi.h)

  • 發行項

啟動更新的異步卸載。

語法

HRESULT BeginUninstall(
  [in]  IUnknown         *onProgressChanged,
  [in]  IUnknown         *onCompleted,
  [in]  VARIANT          state,
  [out] IInstallationJob **retval
);

參數

[in] onProgressChanged

IInstallationProgressChangedCallback 介面，會在卸載完成之前定期呼叫以進行卸載進度變更。

[in] onCompleted

完成安裝作業時所呼叫的 IInstallationCompletedCallback 介面。

[in] state

AsyncState 屬性 IInstallationJob 介面傳回的呼叫端特定狀態。

[out] retval

IInstallationJob 介面，其中包含可供異步卸載作業所起始的屬性和方法。

傳回值

此方法會傳回下列 HRESULT 值和其他 COM 或 Windows

錯誤碼。

傳回碼 Description
S_OK
 已成功啟動更新的異步移除。
WU_E_INSTALL_NOT_ALLOWED
 安裝或移除更新時，請勿呼叫此方法。

只有在 IUpdateInstaller 介面的 IsBusy 屬性傳回VARIANT_FALSE時，才呼叫此方法。
WU_E_NO_UPDATE
 Windows Update Agent (WUA) 集合中沒有更新。

備註

如果您從腳本語言呼叫此方法，請將 onProgressChanged 參數設定為 Automation 物件的識別碼，其分派標識碼 (DSPOD) 為零， (0) 實作回呼例程。 對 onCompleted 參數執行相同的動作。

如果未設定 IUpdateInstaller 的 匯報 屬性，這個方法會傳回WU_E_NO_UPDATE。 如果 匯報 屬性設定為空集合，這個方法也會傳回WU_E_NO_UPDATE。

當您在應用程式中使用任何異步 WUA API 時，您可能需要實作逾時機制。 如需如何執行異步 WUA 作業的詳細資訊，請參閱 異步 WUA 作業的指導方針。

規格需求

需求 值
最低支援的用戶端 Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式]
目標平台 Windows
標頭 wuapi.h
程式庫 Wuguid.lib
Dll Wuapi.dll

另請參閱

IUpdateInstaller