Поделиться через


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

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

Синтаксис

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.

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

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

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

Комментарии

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

Требования

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

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

IBackgroundCopyJob4

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags