Metode IUpdateInstaller::BeginInstall (wuapi.h)

Memulai penginstalan asinkron pembaruan.

Syntax

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

Parameter-parameternya

[in] onProgressChanged

Antarmuka IInstallationProgressChangedCallback yang dipanggil secara berkala untuk perubahan kemajuan penginstalan sebelum penginstalan selesai.

[in] onCompleted

Antarmuka IInstallationCompletedCallback yang dipanggil saat operasi penginstalan selesai.

[in] state

Status khusus penelepon yang dikembalikan oleh properti AsyncState dari antarmuka IInstallationJob .

[out] retval

Antarmuka IInstallationJob yang berisi properti dan metode yang tersedia untuk operasi penginstalan asinkron yang dimulai.

Mengembalikan nilai

Metode ini mengembalikan nilai HRESULT berikut dan COM atau Windows lainnya

kode kesalahan.

Mengembalikan kode	Description
S_OK	Penginstalan asinkron pembaruan berhasil dimulai.
WU_E_INSTALL_NOT_ALLOWED	Anda tidak dapat memanggil metode ini ketika alat penginstal menginstal atau menghapus pembaruan. Hanya panggil metode ini ketika properti IsBusy dari antarmuka IUpdateInstaller mengembalikan VARIANT_FALSE.
WU_E_NO_UPDATE	Agen Windows Update (WUA) tidak memiliki pembaruan dalam koleksi.

Komentar

Jika Anda memanggil metode ini dari bahasa skrip, atur parameter onProgressChanged ke pengidentifikasi objek Automation dengan pengidentifikasi pengiriman (DSIPID) nol (0) yang mengimplementasikan rutinitas panggilan balik. Lakukan hal yang sama untuk parameter onCompleted .

Metode ini mengembalikan WU_E_NO_UPDATE jika properti PembaruanIUpdateInstaller tidak diatur. Metode ini juga mengembalikan WU_E_NO_UPDATE jika properti Pembaruan diatur ke koleksi kosong.

Saat Anda menggunakan API WUA asinkron di aplikasi, Anda mungkin perlu menerapkan mekanisme waktu habis. Untuk informasi selengkapnya tentang cara melakukan operasi WUA asinkron, lihat Panduan untuk Operasi WUA Asinkron.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003, Windows 2000 Server dengan SP3 [hanya aplikasi desktop]
Platform Target	Windows
Header	wuapi.h
Library	Wuguid.lib
DLL	Wuapi.dll

Lihat juga

IUpdateInstaller