BITS_JOB_PROPERTY_ID-Enumeration (bits5_0.h)

  • Artikel

Definiert Konstanten, die die ID der Eigenschaft für den BITS-Auftrag angeben.

Diese Enumeration wird in der BITS_JOB_PROPERTY_VALUE Union verwendet, um den Typ des in der Union enthaltenen Werts zu bestimmen.

Syntax

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

Konstanten

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
Wert: 1
Die ID, die verwendet wird, um das Übertragungsverhalten über Mobilfunknetze und/oder ähnliche Netzwerke zu steuern. Diese Eigenschaft kann während der Übertragung geändert werden– die neuen Kostenflags werden sofort wirksam.

Diese Eigenschaft verwendet das DWORD-Feld des BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
Wert: 2
Die ID, die verwendet wird, um einen COM-Rückruf von CLSID zu registrieren, um Benachrichtigungen über den Fortschritt und den Abschluss eines BITS-Auftrags zu erhalten. Die CLSID muss auf eine Klasse verweisen, die einem registrierten COM-Server außerhalb des Prozesses zugeordnet ist. Es kann auch auf GUID_NULL festgelegt werden, um eine zuvor festgelegte Benachrichtigungs-CLSID zu löschen.

Diese Eigenschaft verwendet das CLsID-Feld des BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
Wert: 3
Die ID zum Markieren eines BITS-Auftrags als bereit zum Herunterladen von Inhalten, die die normalen HTTP-Anforderungen für BITS-Downloads nicht unterstützt: HEAD Anforderungen, den Content-Length-Header und den Content-Range-Header. Das Herunterladen dieser Art von Inhalten ist aktiviert, da BITS Downloads ohne diese Unterstützung nicht anhalten und fortsetzen kann. Wenn ein Auftrag mit aktivierter Eigenschaft aus irgendeinem Grund unterbrochen wird, z. B. aus einem vorübergehenden Verlust der Netzwerkkonnektivität oder dem Neustart des Systems, startet BITS den Download von Anfang an neu, anstatt dort fortzusetzen, wo er aufgehört hat. BITS kann auch die Bandbreitennutzung für dynamische Downloads nicht drosseln. BITS führt keine ungedrosselten Übertragungen für Aufträge durch, für die keine BG_JOB_PRIORITY_FOREGROUND zugewiesen sind. Daher sollten Sie diese Priorität normalerweise jedes Mal festlegen, wenn Sie einen Auftrag festlegen, um dynamische Inhalte zuzulassen.

Diese Eigenschaft verwendet das Feld Aktivieren des BITS_JOB_PROPERTY_VALUE. Diese Eigenschaft wird nur für BG_JOB_TYPE_DOWNLOAD Aufträge unterstützt. Es wird nicht für Downloads unterstützt, die FILE_RANGES verwenden. Diese Eigenschaft kann nur vor dem ersten Aufruf von Resume für einen Auftrag festgelegt werden.
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
Wert: 4
Die ID zum Markieren eines BITS-Auftrags als keine strengen Zuverlässigkeitsgarantien. Das Aktivieren dieser Eigenschaft führt dazu, dass BITS verhindert, dass Informationen über den normalen Auftragsfortschritt beibehalten werden, was BITS normalerweise in regelmäßigen Abständen ausführt. Im Falle eines unerwarteten Herunterfahrens, z. B. eines Stromausfalls, während einer Übertragung führt dies dazu, dass BITS den Fortschritt verliert.

und starten Sie den Auftrag von Anfang an neu, anstatt wie gewohnt dort fortzulaufen, wo er aufgehört hat. Es verringert jedoch auch die Anzahl der Datenträgerschreibvorgänge, die BITS im Laufe der Lebensdauer eines Auftrags vornimmt, was die Leistung für kleinere Aufträge verbessern kann.

Diese Eigenschaft bewirkt auch, dass BITS direkt in die Zieldatei heruntergeladen wird, anstatt in eine temporäre Datei herunterzuladen und die temporäre Datei nach Abschluss der Übertragung an das endgültige Ziel zu verschieben. Dies bedeutet, dass BITS keine teilweise heruntergeladenen Inhalte sauber, wenn ein Auftrag abgebrochen wird oder eine schwerwiegende Fehlerbedingung auftritt. Der BITS-Aufrufer ist für das Bereinigen der Zieldatei verantwortlich, wenn er erstellt wird. Es reduziert jedoch auch den Datenträgeraufwand geringfügig.

Diese Eigenschaft wird nur für Szenarien empfohlen, die eine hohe Anzahl kleiner Aufträge (unter 1 MB) umfassen und keine Zuverlässigkeit bei Stromausfall oder anderen unerwarteten Herunterfahrensereignissen erfordern. Die Leistungseinsparungen sind bei geringer Anzahl von Aufträgen oder bei größeren Aufträgen in der Regel nicht signifikant.

Diese Eigenschaft verwendet das Feld Aktivieren des BITS_JOB_PROPERTY_VALUE. Diese Eigenschaft wird nur für BG_JOB_TYPE_DOWNLOAD Aufträge unterstützt. Diese Eigenschaft kann nur vor dem Hinzufügen von Dateien zu einem Auftrag festgelegt werden.
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
Wert: 5
Die ID zum Markieren der maximalen Anzahl von Bytes, die ein BITS-Auftrag insgesamt herunterladen darf. Diese Eigenschaft ist für die Verwendung mit BITS_JOB_PROPERTY_DYNAMIC_CONTENT vorgesehen, bei der Sie möglicherweise nicht die Größe der Datei bestimmen können, die heruntergeladen werden soll, aber die mögliche Downloadgröße insgesamt begrenzt werden soll.

Diese Eigenschaft verwendet das Feld Aktivieren des BITS_JOB_PROPERTY_VALUE. Diese Eigenschaft wird nur für BG_JOB_TYPE_DOWNLOAD Aufträge unterstützt. Diese Eigenschaft kann nur vor dem ersten Aufruf von Resume für einen Auftrag festgelegt werden.
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
Wert: 7
Die ID zum Markieren eines BITS-Auftrags als bereit, Standardanmeldeinformationen in Anforderungen an Proxyserver aufzunehmen. Das Aktivieren dieser Eigenschaft entspricht dem Festlegen einer WinHTTP-Sicherheitsstufevon WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM für die Anforderungen, die BITS im Namen des Benutzers stellt. Der Benutzer-BITS ruft gespeicherte Anmeldeinformationen aus dem ab, ist identisch mit dem, das netzwerkanforderungen im Auftrag von: BITS verwendet normalerweise die Anmeldeinformationen des Auftragsbesitzers, es sei denn, Sie haben explizit ein Netzwerkhilfstoken angegeben. In diesem Fall verwendet BITS die Anmeldeinformationen des Netzwerkhilfstokens.

Diese Eigenschaft verwendet das Zielfeld des BITS_JOB_PROPERTY_VALUE. Es wird jedoch nur das BG_AUTH_TARGET_PROXY-Ziel unterstützt.
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
Wert: 9
Die ID, die verwendet wird, um das Timing von BITS JobNotification- und FileRangesTransferred-Benachrichtigungen zu steuern. Wenn Sie diese Eigenschaft aktivieren, wird ein Benutzer mit einer anderen Rate benachrichtigt. Diese Eigenschaft kann geändert werden, während eine Übertragung ausgeführt wird. Der neue Tarif kann jedoch nicht sofort angewendet werden. Der Standardwert ist 500 Millisekunden.

Diese Eigenschaft verwendet das DWORD-Feld des BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_ON_DEMAND_MODE
Wert: 10
Die ID, die verwendet wird, um zu steuern, ob sich ein Auftrag im On Demand-Modus befindet. Bei Bedarfsaufträgen kann die App bestimmte Bereiche für einen Dateidownload anfordern, anstatt von Anfang bis Ende herunterzuladen. Der Standardwert ist FALSE. der Auftrag ist nicht bedarfsgesteuert. Bereiche werden mit der IBackgroundCopyFile6::RequestFileRanges-Methode angefordert.

Diese Eigenschaft verwendet das Feld Aktivieren des BITS_JOB_PROPERTY_VALUE.

Die Voraussetzungen für einen BITS_JOB_PROPERTY_ON_DEMAND_MODE Auftrag besteht darin, dass es sich bei der Übertragung um einen BG_JOB_TYPE_DOWNLOAD Auftrag handelt. Der Auftrag darf nicht DYNAMIC sein, und der Server muss ein HTTP- oder HTTPS-Server sein, und die Serveranforderungen für die Bereichsunterstützung müssen alle erfüllt sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Kopfzeile bits5_0.h

Weitere Informationen