IBitsPeerCacheAdministration ::SetConfigurationFlags, méthode (bits3_0.h)

Article
02/28/2024

Définit les indicateurs de configuration qui déterminent si l’ordinateur peut distribuer du contenu à des homologues et télécharger du contenu à partir d’homologues.

Syntaxe

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

Paramètres

[in] Flags

Indicateurs qui déterminent si l’ordinateur peut distribuer du contenu aux pairs et télécharger du contenu à partir d’homologues. Les indicateurs suivants peuvent être définis :

Valeur	Signification
BG_ENABLE_PEERCACHING_CLIENT 0x0001	L’ordinateur peut télécharger du contenu à partir d’homologues. BITS ne télécharge pas les fichiers à partir d’un homologue, sauf si l’ordinateur client et le travail autorisent BITS à télécharger des fichiers à partir d’un homologue. Pour permettre au travail de télécharger des fichiers à partir d’un homologue, appelez la méthode IBackgroundCopyJob4 ::SetPeerCachingFlags et définissez l’indicateur BG_JOB_ENABLE_PEERCACHING_CLIENT. Notez que la modification de cette valeur peut affecter tous les travaux sur l’ordinateur. Si l’une des conditions suivantes existe, BITS arrête le téléchargement et replanifie le travail pour commencer le transfert à partir d’un homologue ou du serveur d’origine, en fonction de la valeur du travail et du cache : Cette valeur pour le cache est TRUE et la valeur du travail bascule entre TRUE et FALSE. Cette valeur pour la propriété de travail est TRUE et la valeur du cache bascule entre TRUE et FALSE. Le téléchargement reprend ensuite là où il s’est arrêté avant que BITS arrête le travail.
BG_ENABLE_PEERCACHING_SERVER 0x0002	L’ordinateur peut distribuer du contenu à des pairs. BITS ne met pas en cache les fichiers et ne les sert pas à des homologues, sauf si l’ordinateur client et le travail autorisent BITS à mettre en cache et à traiter les fichiers. Pour permettre au travail de mettre en cache les fichiers d’un travail, appelez la méthode IBackgroundCopyJob4 ::SetPeerCachingFlags et définissez l’indicateur BG_JOB_ENABLE_PEERCACHING_SERVER.

Valeur

Signification

BG_ENABLE_PEERCACHING_CLIENT
0x0001

L’ordinateur peut télécharger du contenu à partir d’homologues.

BITS ne télécharge pas les fichiers à partir d’un homologue, sauf si l’ordinateur client et le travail autorisent BITS à télécharger des fichiers à partir d’un homologue. Pour permettre au travail de télécharger des fichiers à partir d’un homologue, appelez la méthode IBackgroundCopyJob4 ::SetPeerCachingFlags et définissez l’indicateur BG_JOB_ENABLE_PEERCACHING_CLIENT.

Notez que la modification de cette valeur peut affecter tous les travaux sur l’ordinateur. Si l’une des conditions suivantes existe, BITS arrête le téléchargement et replanifie le travail pour commencer le transfert à partir d’un homologue ou du serveur d’origine, en fonction de la valeur du travail et du cache :

Cette valeur pour le cache est TRUE et la valeur du travail bascule entre TRUE et FALSE.
Cette valeur pour la propriété de travail est TRUE et la valeur du cache bascule entre TRUE et FALSE.

Le téléchargement reprend ensuite là où il s’est arrêté avant que BITS arrête le travail.

BG_ENABLE_PEERCACHING_SERVER
0x0002

L’ordinateur peut distribuer du contenu à des pairs.

BITS ne met pas en cache les fichiers et ne les sert pas à des homologues, sauf si l’ordinateur client et le travail autorisent BITS à mettre en cache et à traiter les fichiers. Pour permettre au travail de mettre en cache les fichiers d’un travail, appelez la méthode IBackgroundCopyJob4 ::SetPeerCachingFlags et définissez l’indicateur BG_JOB_ENABLE_PEERCACHING_SERVER.

Valeur retournée

La méthode retourne les valeurs de retour suivantes.

Code de retour	Description
S_OK	Succès
BG_S_OVERRIDDEN_BY_POLICY	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. La méthode retourne cette valeur si la valeur définie est différente de la valeur de stratégie de groupe. Si les valeurs sont identiques, la méthode retourne S_OK.

Remarques

Cette valeur est utilisée uniquement si la stratégie de groupe EnablePeerCaching n’est pas définie.

Un travail détermine s’il télécharge du contenu à partir d’un homologue ou s’il fournit son contenu à des pairs. Pour plus d’informations, consultez la méthode IBackgroundCopyJob4 ::SetPeerCachingFlags .

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

Voir aussi

IBackgroundCopyJob4 ::SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration ::GetConfigurationFlags

Partager via