IBitsPeerCacheAdministration::SetConfigurationFlags-Methode (bits3_0.h)

Artikel
02/28/2024

Legt die Konfigurationsflags fest, die bestimmen, ob der Computer Inhalte an Peers bereitstellen und Inhalte von Peers herunterladen kann.

Syntax

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

Parameter

[in] Flags

Flags, die bestimmen, ob der Computer Inhalte an Peers bereitstellen und Inhalte von Peers herunterladen kann. Die folgenden Flags können festgelegt werden:

Wert	Bedeutung
BG_ENABLE_PEERCACHING_CLIENT 0x0001	Der Computer kann Inhalte von Peers herunterladen. BITS lädt keine Dateien von einem Peer herunter, es sei denn, sowohl der Clientcomputer als auch der Auftrag erlauben BITS, Dateien von einem Peer herunterzuladen. Um dem Auftrag das Herunterladen von Dateien von einem Peer zu ermöglichen, rufen Sie die IBackgroundCopyJob4::SetPeerCachingFlags-Methode auf, und legen Sie das flag BG_JOB_ENABLE_PEERCACHING_CLIENT fest. Beachten Sie, dass sich die Änderung dieses Werts auf alle Aufträge auf dem Computer auswirken kann. 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.
BG_ENABLE_PEERCACHING_SERVER 0x0002	Der Computer kann Inhalte an Peers bereitstellen. BITS speichert die Dateien nicht zwischen und stellt sie nicht für Peers bereit, es sei denn, der Clientcomputer und der Auftrag erlauben BITS, Dateien zwischenzuspeichern und zu bereitstellen. Damit der Auftrag Dateien für einen Auftrag zwischenspeichern kann, rufen Sie die IBackgroundCopyJob4::SetPeerCachingFlags-Methode auf, und legen Sie das flag BG_JOB_ENABLE_PEERCACHING_SERVER fest.

Wert

Bedeutung

BG_ENABLE_PEERCACHING_CLIENT
0x0001

Der Computer kann Inhalte von Peers herunterladen.

BITS lädt keine Dateien von einem Peer herunter, es sei denn, sowohl der Clientcomputer als auch der Auftrag erlauben BITS, Dateien von einem Peer herunterzuladen. Um dem Auftrag das Herunterladen von Dateien von einem Peer zu ermöglichen, rufen Sie die IBackgroundCopyJob4::SetPeerCachingFlags-Methode auf, und legen Sie das flag BG_JOB_ENABLE_PEERCACHING_CLIENT fest.

Beachten Sie, dass sich die Änderung dieses Werts auf alle Aufträge auf dem Computer auswirken kann. 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.

BG_ENABLE_PEERCACHING_SERVER
0x0002

Der Computer kann Inhalte an Peers bereitstellen.

BITS speichert die Dateien nicht zwischen und stellt sie nicht für Peers bereit, es sei denn, der Clientcomputer und der Auftrag erlauben BITS, Dateien zwischenzuspeichern und zu bereitstellen. Damit der Auftrag Dateien für einen Auftrag zwischenspeichern kann, rufen Sie die IBackgroundCopyJob4::SetPeerCachingFlags-Methode auf, und legen Sie das flag BG_JOB_ENABLE_PEERCACHING_SERVER fest.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg
BG_S_OVERRIDDEN_BY_POLICY	Die Konfigurationseinstellung wurde erfolgreich gespeichert, aber die Einstellung wird nicht verwendet, da eine konfigurierte Gruppenrichtlinie Einstellung die Einstellung überschreibt. Die -Methode gibt diesen Wert zurück, wenn sich der festgelegte Wert vom Gruppenrichtlinienwert unterscheidet. Wenn die Werte identisch sind, gibt die Methode S_OK zurück.

Hinweise

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

Ein Auftrag bestimmt, ob Inhalte von einem Peer heruntergeladen oder an Peers bereitgestellt werden. Weitere Informationen finden Sie unter der IBackgroundCopyJob4::SetPeerCachingFlags-Methode .

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::SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetConfigurationFlags

Share via