IUpdateInstaller：：BeginInstall 方法 (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

錯誤碼。

傳回碼 描述
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