Metode IBackgroundCopyCallback::JobModification (bits.h)
BITS memanggil implementasi metode JobModification Anda ketika pekerjaan telah dimodifikasi. Layanan menghasilkan peristiwa ini ketika byte ditransfer, file telah ditambahkan ke pekerjaan, properti telah dimodifikasi, atau status pekerjaan telah berubah.
Sintaks
HRESULT JobModification(
[in] IBackgroundCopyJob *pJob,
[in] DWORD dwReserved
);
Parameter
[in] pJob
Berisi metode untuk mengakses informasi properti, kemajuan, dan status pekerjaan. Jangan lepaskan pJob; BITS merilis antarmuka saat metode JobModification kembali.
[in] dwReserved
Disiapkan untuk penggunaan masa mendatang.
Nilai kembali
Metode ini harus mengembalikan S_OK.
Keterangan
Implementasi Anda mungkin tidak menerima semua peristiwa modifikasi dalam kondisi beban sumber daya maksimum.
BITS menghasilkan volume peristiwa modifikasi yang tinggi; pertimbangkan untuk membuat timer dan polling untuk informasi status dan kemajuan atau membatasi penggunaan panggilan balik ini. Jika Anda menggunakan panggilan balik ini, jaga agar implementasi Anda tetap singkat.
BITS tidak menghasilkan peristiwa modifikasi ketika status pekerjaan berubah menjadi BG_JOB_STATE_ERROR atau BG_JOB_STATE_TRANSFERRED.
Contoh
Lihat contoh kode untuk antarmuka IBackgroundCopyCallback .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP |
Server minimum yang didukung | Windows Server 2003 |
Target Platform | Windows |
Header | bits.h |