Metode IBackgroundCopyCallback::JobModification (bits.h)

Artikel
02/26/2024

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.

Catatan BITS mendukung hingga empat pemberitahuan simultan per pengguna. Jika satu atau beberapa aplikasi memblokir keempat pemberitahuan untuk pengguna agar tidak kembali, aplikasi yang berjalan sebagai pengguna yang sama tidak akan menerima pemberitahuan sampai satu atau beberapa pemberitahuan pemblokiran kembali.

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

Lihat juga

IBackgroundCopyCallback

IBackgroundCopyJob

Bagikan melalui