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 不会删除该文件。