IBitsPeerCacheAdministration：：SetMaximumCacheSize 方法 (bits3_0.h)

指定快取的大小上限。

語法

HRESULT SetMaximumCacheSize(
  [in] DWORD Bytes
);

[in] Bytes

快取的大小上限，以可用硬碟空間的百分比表示。

方法會傳回下列傳回值。

傳回碼	描述
S_OK	Success
S_FALSE	設定喜好設定已成功儲存，但不會使用喜好設定，因為已設定的群組原則設定會覆寫喜好設定。

只有在未設定 MaxCacheSize 組策略時，才會使用此值。

如果達到快取大小上限，BITS 會移除最近存取的最小檔案，直到釋放必要的磁碟空間為止。如果您指定小於目前快取大小的值，BITS 會從快取中移除檔案，直到符合要求的大小為止。 BITS 會根據年齡移除檔案。大於快取大小的檔案不會快取。

根據預設，快取大小上限為磁碟大小的1%。 BITS 不會使用限制來保留快取的磁碟空間。如果可用磁碟空間，BITS 將最多使用快取的指定限制。您可以指定的最大值是磁碟大小的 80%。

如果要求減少快取的大小，且 BITS 目前正在從快取下載檔案，則 BITS 將不會移除檔案，直到下載完成為止。