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

Указывает максимальный размер кэша.

Синтаксис

HRESULT SetMaximumCacheSize(
  [in] DWORD Bytes
);

Параметры

[in] Bytes

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

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

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

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

Комментарии

Это значение используется только в том случае, если групповая политика MaxCacheSize не задана.

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

По умолчанию максимальный размер кэша составляет 1 % от размера диска. BITS не использует ограничение для резервирования места на диске для кэша. BITS будет использовать до указанного предела для кэша, если дисковое пространство доступно. Максимальное значение, которое можно указать, составляет 80 % от размера диска.

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

Требования

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

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

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetMaximumCacheSize

IBitsPeerCacheAdministration::SetMaximumContentAge