Méthode IBackgroundCopyJob4 ::SetPeerCachingFlags (bits3_0.h)

Article
02/26/2024

Définit les indicateurs qui déterminent si les fichiers du travail peuvent être mis en cache et servis aux pairs, et si le travail peut télécharger le contenu des pairs.

Syntaxe

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

Paramètres

[in] Flags

Indicateurs qui déterminent si les fichiers du travail peuvent être mis en cache et servis aux pairs, et si le travail peut télécharger du contenu à partir d’homologues. Les indicateurs suivants peuvent être définis :

Valeur	Signification
BG_JOB_ENABLE_PEERCACHING_CLIENT 0x0001	Le travail peut télécharger du contenu à partir d’homologues. Le travail ne sera pas téléchargé à partir d’un homologue, sauf si l’ordinateur client et le travail autorisent le service BITS (Background Intelligent Transfer Service) à télécharger des fichiers à partir d’un homologue. Pour permettre à l’ordinateur client de télécharger des fichiers à partir d’un homologue, définissez la stratégie de groupe EnablePeerCaching ou appelez la méthode IBitsPeerCacheAdministration ::SetConfigurationFlags et définissez l’indicateur BG_ENABLE_PEERCACHING_CLIENT. 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. BITS 4.0 : Cet indicateur est déconseillé.
BG_JOB_ENABLE_PEERCACHING_SERVER 0x0002	Les fichiers du travail peuvent être mis en cache et servis aux homologues. 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 autoriser BITS à mettre en cache et à traiter les fichiers sur l’ordinateur client, définissez la stratégie de groupe EnablePeerCaching ou appelez la méthode IBitsPeerCacheAdministration ::SetConfigurationFlags et définissez l’indicateur BG_ENABLE_PEERCACHING_SERVER. BITS 4.0 : Cet indicateur est déconseillé.
BG_JOB_DISABLE_BRANCH_CACHE 0x0004	BITS n’utilisera pas Windows BranchCache pour les travaux de transfert. Ce paramètre n’affecte pas l’utilisation de Windows BranchCache par des applications autres que BITS.

Valeur

Signification

BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001

Le travail peut télécharger du contenu à partir d’homologues.

Le travail ne sera pas téléchargé à partir d’un homologue, sauf si l’ordinateur client et le travail autorisent le service BITS (Background Intelligent Transfer Service) à télécharger des fichiers à partir d’un homologue. Pour permettre à l’ordinateur client de télécharger des fichiers à partir d’un homologue, définissez la stratégie de groupe EnablePeerCaching ou appelez la méthode IBitsPeerCacheAdministration ::SetConfigurationFlags et définissez l’indicateur BG_ENABLE_PEERCACHING_CLIENT.

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. BITS 4.0 : Cet indicateur est déconseillé.

BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002

Les fichiers du travail peuvent être mis en cache et servis aux homologues.

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 autoriser BITS à mettre en cache et à traiter les fichiers sur l’ordinateur client, définissez la stratégie de groupe EnablePeerCaching ou appelez la méthode IBitsPeerCacheAdministration ::SetConfigurationFlags et définissez l’indicateur BG_ENABLE_PEERCACHING_SERVER. BITS 4.0 : Cet indicateur est déconseillé.

BG_JOB_DISABLE_BRANCH_CACHE
0x0004

BITS n’utilisera pas Windows BranchCache pour les travaux de transfert. Ce paramètre n’affecte pas l’utilisation de Windows BranchCache par des applications autres que BITS.

Valeur retournée

La méthode retourne les valeurs suivantes.

Code de retour	Description
S_OK	Succès

Remarques

La définition de ces indicateurs n’a de sens que si la mise en cache d’homologue a été activée en définissant la stratégie de groupe EnablePeerCaching ou en appelant IBitsPeerCacheAdministration ::SetConfigurationFlags.

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

IBackgroundCopyJob4 ::GetPeerCachingFlags

IBitsPeerCacheAdministration ::SetConfigurationFlags

Partager via