Metode IBackgroundCopyJob::GetError (bits.h)

Artikel
02/26/2024

Mengambil antarmuka kesalahan setelah terjadi kesalahan.

BITS 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 BITS 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

[out] ppError

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

Menampilkan nilai

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Menampilkan kode	Deskripsi
S_OK	Berhasil menghasilkan objek kesalahan.
BG_E_ERROR_INFORMATION_UNAVAILABLE	Antarmuka kesalahan hanya tersedia setelah kesalahan terjadi (BG_JOB_STATE_ERROR atau BG_JOB_STATE_TRANSIENT_ERROR) dan sebelum BITS mulai mentransfer data (BG_JOB_STATE_TRANSFERRING).

Keterangan

Pekerjaan ditempatkan dalam status kesalahan pada kesalahan fatal atau setelah periode batas waktu tidak ada kemajuan kedaluwarsa untuk kesalahan sementara (periode ini diambil dari metode GetNoProgressTimeout ). 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 .

Jika pekerjaan tetap dalam status kesalahan selama 90 hari (default JobInactivityTimeout Kebijakan Grup), layanan menghapus pekerjaan dari antrean dan menghapus file sementara pada klien; penghapusan pekerjaan tidak memengaruhi file yang telah berhasil diunggah.

Untuk menentukan apakah bagian aplikasi pengunggahan, balasan, atau server dari pekerjaan balasan unggahan gagal, panggil metode IBackgroundCopyError::GetError untuk mengambil konteks di mana kesalahan terjadi. Aplikasi server gagal jika konteksnya BG_ERROR_CONTEXT_REMOTE_APPLICATION. Jika kesalahannya adalah dengan unggahan atau balasan, konteksnya adalah BG_ERROR_CONTEXT_REMOTE_FILE. Unggahan gagal jika anggota BytesTotal dari struktur BG_JOB_REPLY_PROGRESS BG_SIZE_UNKNOWN. Jika tidak, balasan gagal.

Contoh

Lihat kode contoh dalam topik Penanganan Kesalahan .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP
Server minimum yang didukung	Windows Server 2003
Target Platform	Windows
Header	bits.h
Pustaka	Bits.lib
DLL	QmgrPrxy.dll

Lihat juga

IBackgroundCopyCallback::JobError

IBackgroundCopyError

IBackgroundCopyJob::GetState