Metode IBackgroundCopyJob4::SetPeerCachingFlags (bits3_0.h)

Artikel
08/22/2023

Mengatur bendera yang menentukan apakah file pekerjaan dapat di-cache dan disajikan ke rekan-rekan dan apakah pekerjaan dapat mengunduh konten dari rekan-rekan.

Sintaks

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

Parameter

[in] Flags

Bendera yang menentukan apakah file pekerjaan dapat di-cache dan dilayani ke serekan dan apakah pekerjaan dapat mengunduh konten dari serekan. Bendera berikut dapat diatur:

Nilai	Makna
BG_JOB_ENABLE_PEERCACHING_CLIENT 0x0001	Pekerjaan dapat mengunduh konten dari rekan-rekan. Pekerjaan tidak akan diunduh dari serekan kecuali komputer klien dan pekerjaan memungkinkan Layanan Transfer Cerdas Latar Belakang (BITS) untuk mengunduh file dari serekan. Untuk mengaktifkan komputer klien untuk mengunduh file dari serekan, atur kebijakan grup EnablePeerCaching atau panggil metode IBitsPeerCacheAdministration::SetConfigurationFlags dan atur bendera BG_ENABLE_PEERCACHING_CLIENT. 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 ADALAH TRUE dan nilai untuk pengalih cache antara TRUE dan FALSE. Unduhan kemudian akan dilanjutkan dari tempat yang ditinggalkannya sebelum BITS menghentikan pekerjaan. BIT 4.0: Bendera ini tidak digunakan lagi.
BG_JOB_ENABLE_PEERCACHING_SERVER 0x0002	File pekerjaan dapat di-cache dan disajikan kepada rekan-rekan. BITS tidak akan menyimpan file dan menyajikannya ke serekan kecuali komputer klien dan pekerjaan memungkinkan BITS untuk menyimpan dan melayani file. Untuk mengizinkan BITS melakukan cache dan menyajikan file di komputer klien, atur kebijakan grup EnablePeerCaching atau panggil metode IBitsPeerCacheAdministration::SetConfigurationFlags dan atur bendera BG_ENABLE_PEERCACHING_SERVER. BIT 4.0: Bendera ini tidak digunakan lagi.
BG_JOB_DISABLE_BRANCH_CACHE 0x0004	BITS tidak akan menggunakan Windows BranchCache untuk mentransfer pekerjaan. Pengaturan ini tidak mempengaruhi penggunaan Windows BranchCache oleh aplikasi selain BITS.

Nilai

Makna

BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001

Pekerjaan dapat mengunduh konten dari rekan-rekan.

Pekerjaan tidak akan diunduh dari serekan kecuali komputer klien dan pekerjaan memungkinkan Layanan Transfer Cerdas Latar Belakang (BITS) untuk mengunduh file dari serekan. Untuk mengaktifkan komputer klien untuk mengunduh file dari serekan, atur kebijakan grup EnablePeerCaching atau panggil metode IBitsPeerCacheAdministration::SetConfigurationFlags dan atur bendera BG_ENABLE_PEERCACHING_CLIENT.

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 ADALAH TRUE dan nilai untuk pengalih cache antara TRUE dan FALSE.

Unduhan kemudian akan dilanjutkan dari tempat yang ditinggalkannya sebelum BITS menghentikan pekerjaan. BIT 4.0: Bendera ini tidak digunakan lagi.

BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002

File pekerjaan dapat di-cache dan disajikan kepada rekan-rekan.

BITS tidak akan menyimpan file dan menyajikannya ke serekan kecuali komputer klien dan pekerjaan memungkinkan BITS untuk menyimpan dan melayani file. Untuk mengizinkan BITS melakukan cache dan menyajikan file di komputer klien, atur kebijakan grup EnablePeerCaching atau panggil metode IBitsPeerCacheAdministration::SetConfigurationFlags dan atur bendera BG_ENABLE_PEERCACHING_SERVER. BIT 4.0: Bendera ini tidak digunakan lagi.

BG_JOB_DISABLE_BRANCH_CACHE
0x0004

BITS tidak akan menggunakan Windows BranchCache untuk mentransfer pekerjaan. Pengaturan ini tidak mempengaruhi penggunaan Windows BranchCache oleh aplikasi selain BITS.

Nilai kembali

Metode ini mengembalikan nilai-nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil

Keterangan

Mengatur bendera ini hanya berarti jika penembolokan serekan telah diaktifkan dengan mengatur kebijakan grup EnablePeerCaching atau memanggil IBitsPeerCacheAdministration::SetConfigurationFlags.

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

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags

Bagikan melalui