Метод IBitsPeerCacheAdministration::SetConfigurationFlags (bits3_0.h)

Статья
08/22/2023

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

Синтаксис

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

Параметры

[in] Flags

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

Значение	Значение
BG_ENABLE_PEERCACHING_CLIENT 0x0001	Компьютер может скачивать содержимое из одноранговых узлов. BITS не будет скачивать файлы из однорангового узла, если только клиентский компьютер и задание не разрешают BITS скачивать файлы из однорангового узла. Чтобы разрешить заданию скачивать файлы из однорангового узла, вызовите метод IBackgroundCopyJob4::SetPeerCachingFlags и установите флаг BG_JOB_ENABLE_PEERCACHING_CLIENT. Обратите внимание, что изменение этого значения может повлиять на все задания на компьютере. Если существует одно из следующих условий, BITS остановит скачивание и перепланирует задание, чтобы начать передачу с однорангового узла или сервера-источника в зависимости от значения задания и кэша: Это значение для кэша равно TRUE , а значение задания переключается между TRUE и FALSE. Это значение свойства задания равно TRUE , а значение кэша переключается между TRUE и FALSE. Скачивание будет возобновлено с того места, где оно остановлено до того, как BITS остановило задание.
BG_ENABLE_PEERCACHING_SERVER 0x0002	Компьютер может предоставлять содержимое одноранговым узлам. BITS не будет кэшировать файлы и предоставлять их одноранговым узлам, если только клиентский компьютер и задание не разрешают BITS кэшировать и обслуживать файлы. Чтобы разрешить заданию кэшировать файлы для задания, вызовите метод IBackgroundCopyJob4::SetPeerCachingFlags и установите флаг BG_JOB_ENABLE_PEERCACHING_SERVER.

Значение

BG_ENABLE_PEERCACHING_CLIENT
0x0001

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

BITS не будет скачивать файлы из однорангового узла, если только клиентский компьютер и задание не разрешают BITS скачивать файлы из однорангового узла. Чтобы разрешить заданию скачивать файлы из однорангового узла, вызовите метод IBackgroundCopyJob4::SetPeerCachingFlags и установите флаг BG_JOB_ENABLE_PEERCACHING_CLIENT.

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

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

Скачивание будет возобновлено с того места, где оно остановлено до того, как BITS остановило задание.

BG_ENABLE_PEERCACHING_SERVER
0x0002

Компьютер может предоставлять содержимое одноранговым узлам.

BITS не будет кэшировать файлы и предоставлять их одноранговым узлам, если только клиентский компьютер и задание не разрешают BITS кэшировать и обслуживать файлы. Чтобы разрешить заданию кэшировать файлы для задания, вызовите метод IBackgroundCopyJob4::SetPeerCachingFlags и установите флаг BG_JOB_ENABLE_PEERCACHING_SERVER.

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

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

Код возврата	Описание
S_OK	Успешное завершение
BG_S_OVERRIDDEN_BY_POLICY	Настройки конфигурации успешно сохранены, но они не будут использоваться, так как настроенный параметр групповая политика переопределяет этот параметр. Метод возвращает это значение, если набор значений отличается от значения групповой политики. Если значения совпадают, метод возвращает S_OK.

Код возврата

Описание

S_OK

Успешное завершение

BG_S_OVERRIDDEN_BY_POLICY

Настройки конфигурации успешно сохранены, но они не будут использоваться, так как настроенный параметр групповая политика переопределяет этот параметр.

Метод возвращает это значение, если набор значений отличается от значения групповой политики. Если значения совпадают, метод возвращает S_OK.

Задание определяет, загружает ли оно содержимое из однорангового узла или предоставляет его содержимое одноранговым узлам. Дополнительные сведения см. в методе IBackgroundCopyJob4::SetPeerCachingFlags .

Требования

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

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

IBackgroundCopyJob4::SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetConfigurationFlags

Share via