Метод IBackgroundCopyJob4::SetPeerCachingFlags (bits3_0.h)

Статья
08/22/2023

Задает флаги, которые определяют, можно ли кэшировать файлы задания и предоставлять их одноранговым узлам, а также может ли задание скачивать содержимое из одноранговых узлов.

Синтаксис

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

Параметры

[in] Flags

Флаги, определяющие, можно ли кэшировать файлы задания и предоставлять их одноранговым узлам и может ли задание скачивать содержимое из одноранговых узлов. Можно задать следующие флаги:

Значение	Значение
BG_JOB_ENABLE_PEERCACHING_CLIENT 0x0001	Задание может скачивать содержимое из одноранговых узлов. Задание не будет загружаться с однорангового узла, если клиентский компьютер и задание не разрешают фоновой интеллектуальной службе передачи (BITS) скачивать файлы из однорангового узла. Чтобы разрешить клиентскому компьютеру скачивать файлы из однорангового узла, установите групповую политику EnablePeerCaching или вызовите метод IBitsPeerCacheAdministration::SetConfigurationFlags и установите флаг BG_ENABLE_PEERCACHING_CLIENT. Если существует одно из следующих условий, BITS остановит скачивание и перепланирует задание, чтобы начать передачу с однорангового узла или сервера-источника в зависимости от значения задания и кэша: Это значение для кэша равно TRUE , а значение задания переключается между TRUE и FALSE. Это значение свойства задания равно TRUE , а значение кэша переключается между TRUE и FALSE. Скачивание будет возобновлено с того места, где оно остановлено до того, как BITS остановило задание. BITS 4.0: Этот флаг является нерекомендуемой.
BG_JOB_ENABLE_PEERCACHING_SERVER 0x0002	Файлы задания можно кэшировать и предоставлять одноранговым узлам. BITS не будет кэшировать файлы и предоставлять их одноранговым узлам, если только клиентский компьютер и задание не разрешают BITS кэшировать и обслуживать файлы. Чтобы разрешить BITS кэшировать и обслуживать файлы на клиентском компьютере, задайте групповую политику EnablePeerCaching или вызовите метод IBitsPeerCacheAdministration::SetConfigurationFlags и установите флаг BG_ENABLE_PEERCACHING_SERVER. BITS 4.0: Этот флаг является нерекомендуемой.
BG_JOB_DISABLE_BRANCH_CACHE 0x0004	BITS не будет использовать Windows BranchCache для передачи заданий. Этот параметр не влияет на использование Windows BranchCache приложениями, отличными от BITS.

Значение

BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001

Задание может скачивать содержимое из одноранговых узлов.

Задание не будет загружаться с однорангового узла, если клиентский компьютер и задание не разрешают фоновой интеллектуальной службе передачи (BITS) скачивать файлы из однорангового узла. Чтобы разрешить клиентскому компьютеру скачивать файлы из однорангового узла, установите групповую политику EnablePeerCaching или вызовите метод IBitsPeerCacheAdministration::SetConfigurationFlags и установите флаг BG_ENABLE_PEERCACHING_CLIENT.

Если существует одно из следующих условий, BITS остановит скачивание и перепланирует задание, чтобы начать передачу с однорангового узла или сервера-источника в зависимости от значения задания и кэша:

Это значение для кэша равно TRUE , а значение задания переключается между TRUE и FALSE.
Это значение свойства задания равно TRUE , а значение кэша переключается между TRUE и FALSE.

Скачивание будет возобновлено с того места, где оно остановлено до того, как BITS остановило задание. BITS 4.0: Этот флаг является нерекомендуемой.

BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002

Файлы задания можно кэшировать и предоставлять одноранговым узлам.

BITS не будет кэшировать файлы и предоставлять их одноранговым узлам, если только клиентский компьютер и задание не разрешают BITS кэшировать и обслуживать файлы. Чтобы разрешить BITS кэшировать и обслуживать файлы на клиентском компьютере, задайте групповую политику EnablePeerCaching или вызовите метод IBitsPeerCacheAdministration::SetConfigurationFlags и установите флаг BG_ENABLE_PEERCACHING_SERVER. BITS 4.0: Этот флаг является нерекомендуемой.

BG_JOB_DISABLE_BRANCH_CACHE
0x0004

BITS не будет использовать Windows BranchCache для передачи заданий. Этот параметр не влияет на использование Windows BranchCache приложениями, отличными от BITS.

Возвращаемое значение

Метод возвращает следующие значения.

Код возврата	Описание
S_OK	Успешное завершение

Установка этих флагов имеет значение только в том случае, если одноранговое кэширование было включено путем установки групповой политики EnablePeerCaching или вызова IBitsPeerCacheAdministration::SetConfigurationFlags.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	bits3_0.h (включая Bits.h)
Библиотека	Bits.lib

См. также раздел

IBackgroundCopyJob4

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags