Metode IBackgroundCopyCallback::JobError

Pengoptimalan Pengiriman memanggil implementasi metode JobError Anda ketika status pekerjaan berubah menjadi BG_JOB_STATE_ERROR.

Sintaks

HRESULT JobError(
  [in] IBackgroundCopyJob   *pJob,
  [in] IBackgroundCopyError *pError
);

Parameter

pJob [in]

Berisi informasi terkait pekerjaan, seperti jumlah byte dan file yang ditransfer sebelum kesalahan terjadi. Ini juga berisi metode untuk melanjutkan dan membatalkan pekerjaan. Jangan melepaskan pJob; Pengoptimalan Pengiriman merilis antarmuka saat metode JobError kembali.

pError [in]

Berisi informasi kesalahan, seperti file yang sedang diproses pada saat kesalahan fatal terjadi dan deskripsi kesalahan. Jangan melepaskan pError; Pengoptimalan Pengiriman merilis antarmuka saat metode JobError kembali.

Mengembalikan nilai

Metode ini harus mengembalikan S_OK; jika tidak, Pengoptimalan Pengiriman terus memanggil metode ini sampai S_OK dikembalikan. Untuk alasan performa, Anda harus membatasi berapa kali Anda mengembalikan nilai selain S_OK hingga beberapa kali. Sebagai alternatif untuk mengembalikan kode kesalahan, pertimbangkan untuk selalu mengembalikan S_OK dan menangani kesalahan secara internal. Interval di mana metode ini dipanggil bersifat arbitrer.

Keterangan

Setelah Anda menentukan penyebab kesalahan, lakukan salah satu opsi berikut:

• Untuk membatalkan pekerjaan, panggil metode IBackgroundCopyJob::Cancel .
• Untuk menerima bagian pekerjaan yang berhasil ditransfer sebelum kesalahan terjadi, panggil metode IBackgroundCopyJob::Complete . Opsi ini tidak berlaku untuk mengunggah pekerjaan; Anda tidak dapat menyelesaikan sebagian pekerjaan pengunggahan.
• Untuk menyelesaikan pemrosesan pekerjaan, perbaiki masalah, lalu panggil metode IBackgroundCopyJob::Resume .

Kesalahan sementara tidak menghasilkan panggilan ke metode JobError .

Pengoptimalan Pengiriman mengembalikan BG_ERROR_CONTEXT_REMOTE_FILE jika pekerjaan mencapai kesalahan HTTP 403, BG_ERROR_CONTEXT_NONE sebaliknya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server, versi 1709 [hanya aplikasi desktop]
Header	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Pustaka	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyCallback didefinisikan sebagai 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22

Lihat juga

IBackgroundCopyCallback

IBackgroundCopyError

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::Resume