IBitsPeerCacheAdministration::SetMaximumCacheSize-Methode (bits3_0.h)

Gibt die maximale Größe des Caches an.

Syntax

HRESULT SetMaximumCacheSize(
  [in] DWORD Bytes
);

Parameter

[in] Bytes

Maximale Größe des Caches als Prozentsatz des verfügbaren Festplattenspeichers.

Rückgabewert

Die -Methode gibt die folgenden Rückgabewerte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg
S_FALSE
Die Konfigurationseinstellung wurde erfolgreich gespeichert, aber die Einstellung wird nicht verwendet, da eine konfigurierte Gruppenrichtlinie Einstellung die Einstellung außer Kraft setzt.

Hinweise

Dieser Wert wird nur verwendet, wenn die MaxCacheSize-Gruppenrichtlinie nicht festgelegt ist.

Wenn die maximale Cachegröße erreicht ist, entfernt BITS die Dateien, auf die zuletzt am wenigsten zugegriffen wurde, bis der erforderliche Speicherplatz freigegeben wurde. Wenn Sie einen Wert angeben, der kleiner als die aktuelle Cachegröße ist, entfernt BITS Dateien aus dem Cache, bis die angeforderte Größe erfüllt ist. BITS entfernt die Dateien basierend auf dem Alter. Dateien, die größer als die Cachegröße sind, werden nicht zwischengespeichert.

Standardmäßig beträgt die maximale Cachegröße 1 % der Datenträgergröße. BITS verwendet das Limit nicht, um Speicherplatz für den Cache zu reservieren. BITS wird bis zum angegebenen Grenzwert für den Cache verwendet, wenn der Speicherplatz verfügbar ist. Der Maximalwert, den Sie angeben können, beträgt 80 % der Datenträgergröße.

Wenn die Anforderung darin besteht, die Größe des Caches zu reduzieren und BITS derzeit eine Datei aus dem Cache herunter lädt, entfernt BITS die Datei erst, wenn der Download abgeschlossen ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile bits3_0.h (bits.h einschließen)
Bibliothek Bits.lib

Weitere Informationen

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetMaximumCacheSize

IBitsPeerCacheAdministration::SetMaximumContentAge