共用方式為

IUpdateInstaller：：BeginInstall method （wuapi.h）

啟動非同步更新安裝。

語法

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

參數

[in] onProgressChanged

一個 IInstallationProgressChangedCallback 介面，會在安裝完成前定期呼叫以變更安裝進度。

[in] onCompleted

一個 IInstallationCompletedCallback 介面，當安裝操作完成時會被呼叫。

[in] state

由 IInstallationJob 介面的 AsyncState 屬性回傳呼叫者專屬狀態。

[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 物件的識別碼，該物件的派遣識別碼（DSIPID）為零（0），該物件實作回撥例程。 對 onCompleted 參數也做同樣的事。

若 IUpdateInstaller 的 Updates 屬性未設定，此方法會回傳 WU_E_NO_UPDATE。 若 Updates 屬性設定為空集合，此方法也會回傳 WU_E_NO_UPDATE。

當你在應用程式中使用任何非同步 WUA API 時，可能需要實作逾時機制。 欲了解更多如何執行非同步 WUA 操作的資訊，請參閱非 同步 WUA 操作指引。

需求

Requirement 價值觀
最低支援的用戶端 Windows XP、Windows 2000 Professional SP3 [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003、Windows 2000 Server SP3 [僅限傳統型應用程式]
目標平臺 窗戶
Header wuapi.h
Library Wuguid.lib
DLL Wuapi.dll

另請參閱

IUpdateInstaller

  • Last updated on