Bagikan melalui

Metode IBitsPeerCacheAdministration::SetConfigurationFlags (bits3_0.h)

  • Artikel

Mengatur bendera konfigurasi yang menentukan apakah komputer dapat menyajikan konten ke serekan dan dapat mengunduh konten dari rekan-rekan.

Sintaks

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

Parameter

[in] Flags

Bendera yang menentukan apakah komputer dapat menyajikan konten ke rekan dan dapat mengunduh konten dari serekan. Bendera berikut dapat diatur:

Nilai Makna
BG_ENABLE_PEERCACHING_CLIENT
0x0001
 Komputer dapat mengunduh isi dari rekan-rekan.

BITS tidak akan mengunduh file dari serekan kecuali komputer klien dan pekerjaan mengizinkan BITS mengunduh file dari serekan. Untuk mengizinkan pekerjaan mengunduh file dari peer, panggil metode IBackgroundCopyJob4::SetPeerCachingFlags dan atur bendera BG_JOB_ENABLE_PEERCACHING_CLIENT.

Perhatikan bahwa mengubah nilai ini dapat memengaruhi semua pekerjaan di komputer. Jika salah satu kondisi berikut ada, BITS akan menghentikan pengunduhan dan menjadwalkan ulang pekerjaan untuk mulai mentransfer dari peer atau server asal, tergantung pada nilai untuk pekerjaan dan cache:

  • Nilai untuk cache ini TRUE dan nilai untuk pekerjaan beralih antara TRUE dan FALSE.
  • Nilai untuk properti pekerjaan ini TRUE dan nilai untuk tombol cache antara TRUE dan FALSE.
Unduhan kemudian akan dilanjutkan dari tempat yang ditinggalkannya sebelum BITS menghentikan pekerjaan.
BG_ENABLE_PEERCACHING_SERVER
0x0002
 Komputer dapat menyajikan isi ke rekan-rekan.

BITS tidak akan menyimpan file dan melayaninya untuk serekan kecuali komputer klien dan pekerjaan mengizinkan BITS untuk menyimpan dan melayani file. Untuk mengizinkan pekerjaan menyimpan file untuk pekerjaan, panggil metode IBackgroundCopyJob4::SetPeerCachingFlags dan atur bendera BG_JOB_ENABLE_PEERCACHING_SERVER.

Nilai kembali

Metode mengembalikan nilai pengembalian berikut.

Menampilkan kode Deskripsi
S_OK
 Berhasil
BG_S_OVERRIDDEN_BY_POLICY
 Preferensi konfigurasi telah berhasil disimpan, tetapi preferensi tidak akan digunakan karena pengaturan Kebijakan Grup yang dikonfigurasi mengambil alih preferensi.

Metode mengembalikan nilai ini jika nilai yang ditetapkan berbeda dari nilai kebijakan grup. Jika nilainya sama, metode akan mengembalikan S_OK.

Keterangan

Nilai ini hanya digunakan jika kebijakan grup EnablePeerCaching tidak ditetapkan.

Pekerjaan menentukan apakah ia mengunduh konten dari serekan atau menyajikan kontennya kepada serekan. Untuk detailnya, lihat metode IBackgroundCopyJob4::SetPeerCachingFlags .

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

IBackgroundCopyJob4::SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetConfigurationFlags