IBitsPeerCacheAdministration ::SetMaximumCacheSize, méthode (bits3_0.h)
Spécifie la taille maximale du cache.
Syntaxe
HRESULT SetMaximumCacheSize(
[in] DWORD Bytes
);
Paramètres
[in] Bytes
Taille maximale du cache, en pourcentage de l’espace disque dur disponible.
Valeur retournée
La méthode retourne les valeurs de retour suivantes.
| Code de retour | Description |
|---|---|
|
Succès |
|
La préférence de configuration a été enregistrée avec succès, mais elle ne sera pas utilisée, car un paramètre de stratégie de groupe configuré remplace la préférence. |
Remarques
Cette valeur est utilisée uniquement si la stratégie de groupe MaxCacheSize n’est pas définie.
Si la taille maximale du cache est atteinte, BITS supprime les fichiers les moins consultés jusqu’à ce que l’espace disque nécessaire soit libéré. Si vous spécifiez une valeur inférieure à la taille actuelle du cache, BITS supprime les fichiers du cache jusqu’à ce que la taille demandée soit atteinte. BITS supprime les fichiers en fonction de leur âge. Les fichiers dont la taille est supérieure à la taille du cache ne sont pas mis en cache.
Par défaut, la taille maximale du cache est de 1 % de la taille du disque. BITS n’utilise pas la limite pour réserver de l’espace disque pour le cache. BITS utilise jusqu’à la limite spécifiée pour le cache, si l’espace disque est disponible. La valeur maximale que vous pouvez spécifier est de 80 % de la taille du disque.
Si la demande vise à réduire la taille du cache et que BITS télécharge actuellement un fichier à partir du cache, BITS ne supprime pas le fichier tant que le téléchargement n’est pas terminé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | bits3_0.h (include Bits.h) |
| Bibliothèque | Bits.lib |