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
錯誤碼。
傳回碼 | 描述 |
---|---|
|
已成功啟動更新的非同步安裝。 |
|
當安裝程式正在安裝或移除更新時,您無法呼叫此方法。
只有在IUpdateInstaller介面的IsBusy屬性傳回VARIANT_FALSE時,才呼叫此方法。 |
|
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 |