Metode IBackgroundCopyFile3::SetValidationState (bits3_0.h)

Menyetel status validasi file ini.

Sintaks

HRESULT SetValidationState(
  [in] BOOL state
);

Parameter

[in] state

Atur ke TRUE jika konten file valid, jika tidak, FALSE.

Nilai kembali

Metode mengembalikan nilai pengembalian berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil
E_PENDING	Anda tidak dapat memvalidasi file hingga pengunduhan selesai.
BG_E_RECORD_DELETED	Rekaman cache yang terkait dengan file ini telah dihapus.

Keterangan

Jika Anda mengatur status validasi ke FALSE dan file diunduh dari server asal, pekerjaan berpindah ke status kesalahan dengan kode kesalahan BG_E_VALIDATION_FAILED dan kemajuan file diatur ke nol. Anda kemudian dapat memanggil metode IBackgroundCopyJob::Resume untuk mengunduh file lagi.

BIT 3.0: Jangan panggil metode IBackgroundCopyJob::Resume untuk mengunduh file lagi. Sebagai gantinya, panggil metode IBackgroundCopyJob::Complete atau IBackgroundCopyJob::Cancel untuk membersihkan pekerjaan saat ini lalu buat pekerjaan baru untuk mengunduh file.

Jika Anda mengatur status validasi ke FALSE dan file diunduh dari serekan, BITS menghapus file dari cache, mengatur ulang kemajuan file ke nol, dan mengunduh file lagi dari server asal.

Anda dapat memanggil metode ini hanya setelah BITS selesai mentransfer file. Untuk menerima pemberitahuan ketika transfer selesai, terapkan metode IBackgroundCopyCallback2::FileTransferred .

Memanggil metode IBackgroundCopyJob::Complete secara implisit memvalidasi file.

Jika Anda memvalidasi file di cache lalu memanggil IBackgroundCopyJob4::SetPeerCachingFlags untuk menonaktifkan penembolokan (atau penembolokan serekan dinonaktifkan melalui Kebijakan Grup), file tetap berada di cache. Jika Anda menonaktifkan penembolokan sebelum memvalidasi file, BITS akan menghapus file dari cache.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	bits3_0.h (termasuk Bits.h)
Pustaka	Bits.lib

Lihat juga

IBackgroundCopyFile3

IBackgroundCopyFile3::GetValidationState

IBitsPeerCacheRecord::IsFileValidated