IUpdateDownloader::BeginDownload method (wuapi.h)
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.
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 |
---|---|
|
Komputer tidak dapat mengakses situs pembaruan. |
|
Agen Windows Update (WUA) tidak memiliki pembaruan dalam koleksi. |
|
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 |