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 はダウンロードが完了するまでファイルを削除しません。

要件

要件
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー bits3_0.h (Bits.h を含む)
Library Bits.lib

こちらもご覧ください

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetMaximumCacheSize

IBitsPeerCacheAdministration::SetMaximumContentAge