IBackgroundCopyJob4::SetPeerCachingFlags-Methode (bits3_0.h)

Artikel
02/26/2024

Legt Flags fest, um anzugeben, ob die Dateien eines Auftrags zwischengespeichert und an Peers übermittelt werden können, und ob der Auftrag Inhalte von Peers herunterladen kann.

Syntax

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

Parameter

[in] Flags

Flags, die bestimmen, ob die Dateien des Auftrags zwischengespeichert und für Peers bereitgestellt werden können und ob der Auftrag Inhalte von Peers herunterladen kann. Die folgenden Flags können festgelegt werden:

Wert	Bedeutung
BG_JOB_ENABLE_PEERCACHING_CLIENT 0x0001	Der Auftrag kann Inhalte von Peers herunterladen. Der Auftrag wird nicht von einem Peer heruntergeladen, es sei denn, sowohl der Clientcomputer als auch der Auftrag erlauben dem intelligenten Hintergrundübertragungsdienst (Background Intelligent Transfer Service, BITS) das Herunterladen von Dateien von einem Peer. Um dem Clientcomputer das Herunterladen von Dateien von einem Peer zu ermöglichen, legen Sie die Gruppenrichtlinie EnablePeerCaching fest, oder rufen Sie die IBitsPeerCacheAdministration::SetConfigurationFlags-Methode auf, und legen Sie das flag BG_ENABLE_PEERCACHING_CLIENT fest. Wenn eine der folgenden Bedingungen vorhanden ist, beendet BITS den Download und plant den Auftrag neu, um mit der Übertragung von einem Peer oder dem Ursprungsserver zu beginnen, abhängig vom Wert für den Auftrag und den Cache: Dieser Wert für den Cache ist TRUE , und der Wert für den Auftrag schaltet zwischen TRUE und FALSE um. Dieser Wert für die Auftragseigenschaft ist TRUE , und der Wert für den Cache schaltet zwischen TRUE und FALSE um. Der Download wird dann dort fortgesetzt, wo er aufgehört hat, bevor BITS den Auftrag beendet hat. BITS 4.0: Dieses Flag ist veraltet.
BG_JOB_ENABLE_PEERCACHING_SERVER 0x0002	Die Dateien des Auftrags können zwischengespeichert und an Peers bereitgestellt werden. BITS speichert die Dateien nicht zwischen und stellt sie nicht an Peers bereit, es sei denn, sowohl der Clientcomputer als auch der Auftrag erlauben BITS, die Dateien zwischenzuspeichern und zu bereitstellen. Damit BITS die Dateien auf dem Clientcomputer zwischenspeichern und bereitstellen kann, legen Sie die Gruppenrichtlinie EnablePeerCaching fest, oder rufen Sie die IBitsPeerCacheAdministration::SetConfigurationFlags-Methode auf, und legen Sie das flag BG_ENABLE_PEERCACHING_SERVER fest. BITS 4.0: Dieses Flag ist veraltet.
BG_JOB_DISABLE_BRANCH_CACHE 0x0004	BITS verwendet Windows BranchCache nicht für Übertragungsaufträge. Diese Einstellung wirkt sich nicht auf die Verwendung von Windows BranchCache durch andere Anwendungen als BITS aus.

Wert

Bedeutung

BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001

Der Auftrag kann Inhalte von Peers herunterladen.

Der Auftrag wird nicht von einem Peer heruntergeladen, es sei denn, sowohl der Clientcomputer als auch der Auftrag erlauben dem intelligenten Hintergrundübertragungsdienst (Background Intelligent Transfer Service, BITS) das Herunterladen von Dateien von einem Peer. Um dem Clientcomputer das Herunterladen von Dateien von einem Peer zu ermöglichen, legen Sie die Gruppenrichtlinie EnablePeerCaching fest, oder rufen Sie die IBitsPeerCacheAdministration::SetConfigurationFlags-Methode auf, und legen Sie das flag BG_ENABLE_PEERCACHING_CLIENT fest.

Wenn eine der folgenden Bedingungen vorhanden ist, beendet BITS den Download und plant den Auftrag neu, um mit der Übertragung von einem Peer oder dem Ursprungsserver zu beginnen, abhängig vom Wert für den Auftrag und den Cache:

Dieser Wert für den Cache ist TRUE , und der Wert für den Auftrag schaltet zwischen TRUE und FALSE um.
Dieser Wert für die Auftragseigenschaft ist TRUE , und der Wert für den Cache schaltet zwischen TRUE und FALSE um.

Der Download wird dann dort fortgesetzt, wo er aufgehört hat, bevor BITS den Auftrag beendet hat. BITS 4.0: Dieses Flag ist veraltet.

BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002

Die Dateien des Auftrags können zwischengespeichert und an Peers bereitgestellt werden.

BITS speichert die Dateien nicht zwischen und stellt sie nicht an Peers bereit, es sei denn, sowohl der Clientcomputer als auch der Auftrag erlauben BITS, die Dateien zwischenzuspeichern und zu bereitstellen. Damit BITS die Dateien auf dem Clientcomputer zwischenspeichern und bereitstellen kann, legen Sie die Gruppenrichtlinie EnablePeerCaching fest, oder rufen Sie die IBitsPeerCacheAdministration::SetConfigurationFlags-Methode auf, und legen Sie das flag BG_ENABLE_PEERCACHING_SERVER fest. BITS 4.0: Dieses Flag ist veraltet.

BG_JOB_DISABLE_BRANCH_CACHE
0x0004

BITS verwendet Windows BranchCache nicht für Übertragungsaufträge. Diese Einstellung wirkt sich nicht auf die Verwendung von Windows BranchCache durch andere Anwendungen als BITS aus.

Rückgabewert

Die Methode gibt die folgenden Werte zurück:

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg

Hinweise

Das Festlegen dieser Flags hat nur dann Bedeutung, wenn das Peerzwischenspeichern aktiviert wurde, indem entweder die Gruppenrichtlinie EnablePeerCaching festgelegt oder IBitsPeerCacheAdministration::SetConfigurationFlags aufgerufen wurde.

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

IBackgroundCopyJob4

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags

Share via