Metode IBackgroundCopyJob::GetError (bits.h)
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 |
---|---|
|
Berhasil menghasilkan objek kesalahan. |
|
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.
- 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 .
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 |