Metode IBackgroundCopyJob::GetError

Mengambil antarmuka kesalahan setelah terjadi kesalahan.

Pengoptimalan Pengiriman menghasilkan objek kesalahan ketika status pekerjaan BG_JOB_STATE_ERROR atau BG_JOB_STATE_TRANSIENT_ERROR. Layanan tidak membuat objek kesalahan ketika panggilan ke metode antarmuka IBackgroundCopyXXXX gagal. Objek kesalahan tersedia sampai Pengoptimalan Pengiriman mulai mentransfer data (status pekerjaan berubah menjadi BG_JOB_STATE_TRANSFERRING) untuk pekerjaan atau sampai aplikasi Anda keluar.

Sintaks

HRESULT GetError(
  [out] IBackgroundCopyError **ppError
);

Parameter

ppError [out]

Antarmuka kesalahan yang menyediakan kode kesalahan, deskripsi kesalahan, dan konteks di mana kesalahan terjadi. Parameter ini juga mengidentifikasi file yang ditransfer pada saat kesalahan terjadi. Lepaskan ppError setelah selesai.

Mengembalikan nilai

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Mengembalikan kode	Deskripsi
S_OK	Berhasil menghasilkan objek kesalahan.
DO_E_ERROR_INFORMATION_UNAVAILABLE	Antarmuka kesalahan hanya tersedia setelah kesalahan terjadi (BG_JOB_STATE_ERROR atau BG_JOB_STATE_TRANSIENT_ERROR) dan sebelum Pengoptimalan Pengiriman mulai mentransfer data (BG_JOB_STATE_TRANSFERRING).

Keterangan

Pekerjaan ditempatkan dalam status kesalahan pada kesalahan fatal. Gunakan salah satu opsi berikut untuk menentukan apakah pekerjaan dalam kesalahan:

• Untuk melakukan polling untuk status pekerjaan, panggil metode IBackgroundCopyJob::GetState . Pekerjaan dalam kesalahan jika statusnya BG_JOB_STATE_ERROR.
• Untuk menerima pemberitahuan ketika terjadi kesalahan, terapkan antarmuka IBackgroundCopyCallback (khususnya, metode JobError ). Kemudian, panggil metode IBackgroundCopyJob::SetNotifyInterface untuk mendaftarkan panggilan balik dan metode IBackgroundCopyJob::SetNotifyFlags untuk mengatur bendera BG_NOTIFY_JOB_ERROR.

Antarmuka IBackgroundCopyError berisi informasi yang Anda gunakan untuk menentukan penyebab kesalahan dan apakah proses transfer dapat dilanjutkan. Setelah Anda menentukan penyebab kesalahan, lakukan salah satu opsi berikut:

• Untuk membatalkan pekerjaan, panggil metode IBackgroundCopyJob::Cancel .
• Untuk menyimpan file yang berhasil ditransfer sebelum kesalahan terjadi, panggil metode IBackgroundCopyJob::Complete .
• Untuk menyelesaikan pemrosesan pekerjaan, perbaiki masalah, lalu panggil metode IBackgroundCopyJob::Resume .

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_IBackgroundCopyJob didefinisikan sebagai 37668D37-507E-4160-9316-26306D150B12

Lihat juga

IBackgroundCopyJob

IBackgroundCopyCallback::JobError

IBackgroundCopyError

IBackgroundCopyJob::GetState