IUpdateDownloader::BeginDownload method (wuapi.h)

Artikel
08/28/2023

Memulai pengunduhan asinkron file konten yang terkait dengan pembaruan.

Sintaks

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

Parameter

[in] onProgressChanged

Antarmuka IDownloadProgressChangedCallback yang dipanggil secara berkala untuk mengunduh perubahan kemajuan sebelum pengunduhan selesai.

[in] onCompleted

Antarmuka IDownloadCompletedCallback (C++/COM) yang dipanggil saat operasi pengunduhan asinkron selesai.

[in] state

Status khusus penelepon yang dikembalikan properti AsyncState dari antarmuka IDownloadJob . Penelepon dapat menggunakan parameter ini untuk melampirkan nilai ke objek pekerjaan unduhan. Ini memungkinkan penelepon untuk mengambil informasi kustom tentang objek pekerjaan pengunduhan tersebut di lain waktu.

Catatan

Properti AsyncState dari antarmuka IDownloadJob dapat diambil, tetapi tidak dapat diatur. Ini tidak mencegah pemanggil mengubah konten objek yang sudah diatur ke properti AsyncState dari antarmuka IDownloadJob . Dengan kata lain, jika properti AsyncState berisi angka, angka tidak dapat diubah. Tetapi, jika properti AsyncState berisi array aman atau objek, konten array aman atau objek dapat diubah sesering mungkin. Nilai dirilis ketika penelepon merilis IDownloadJob dengan memanggil IUpdateDownloader::EndDownload.

[out] retval

Antarmuka IDownloadJob yang berisi properti dan metode yang tersedia untuk operasi pengunduhan yang telah dimulai.

Mengembalikan nilai

Mengembalikan S_OK jika berhasil. Jika tidak, mengembalikan kode kesalahan COM atau Windows.

Metode ini juga dapat mengembalikan kode kesalahan berikut.

Menampilkan kode	Deskripsi
WU_E_INVALID_OPERATION	Komputer tidak dapat mengakses situs pembaruan.
WU_E_NO_UPDATE	Agen Windows Update (WUA) tidak memiliki pembaruan dalam koleksi.
WU_E_NOT_INITIALIZED	Agen Windows Update (WUA) tidak diinisialisasi.

Keterangan

Sebagai alternatif untuk menerapkan antarmuka IDownloadProgressChangedCallback , Anda dapat menggunakan skrip untuk menerapkan rutinitas panggilan balik pengidentifikasi apa pun dengan DISPID 0 pada objek otomatisasi. Jenis parameter onProgressChanged adalah IUnknown*.

Sebagai alternatif untuk menerapkan antarmuka IDownloadCompletedCallback , Anda dapat menggunakan skrip untuk mengimplementasikan rutinitas panggilan balik pengidentifikasi apa pun dengan DISPID 0 pada objek otomatisasi. Jenis parameter onCompleted adalah IUnknown*.

Metode ini mengembalikan WU_E_INVALID_OPERATION jika objek yang mengimplementasikan antarmuka dikunci.

Metode ini mengembalikan WU_E_NO_UPDATE jika properti Updates antarmuka IUpdateDownloader tidak diatur. Metode ini juga mengembalikan WU_E_NO_UPDATE jika properti Updates diatur ke koleksi kosong.

Metode ini mengembalikan SUS_E_NOT_INITIALIZED jika pekerjaan pengunduhan tidak berisi pembaruan.

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]
Target Platform	Windows
Header	wuapi.h
Pustaka	Wuguid.lib
DLL	Wuapi.dll

Lihat juga

IUpdateDownloader

Bagikan melalui