IBackgroundCopyFile6::GetFilledFileRanges-Methode (bits10_1.h)

Gibt die Dateibereiche zurück, die heruntergeladen wurden.

Syntax

HRESULT GetFilledFileRanges(
  [out] DWORD         *rangeCount,
  [out] BG_FILE_RANGE **ranges
);

Parameter

[out] rangeCount

Die Anzahl der Elemente in Bereichen.

[out] ranges

Array von BG_FILE_RANGE Strukturen, das die heruntergeladenen Bereiche beschreibt. Bereiche werden so weit wie möglich zusammengeführt. Die Bereiche werden nach Offset sortiert. Rufen Sie anschließend die CoTaskMemFree-Funktion auf, um Bereiche frei zu machen.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Der Fehler wird E_OUTOFMEMORY , wenn das Array Ranges nicht zugeordnet werden konnte und BG_E_RANDOM_ACCESS_NOT_SUPPORTED , wenn der Auftrag kein Downloadauftrag ist oder wenn der Server seine Fähigkeit verliert, Downloadbereiche zu unterstützen.

Hinweise

GetFilledFileRanges kann für jeden Downloadauftrag angefordert werden, der auch die Anforderungen für BITS_JOB_PROPERTY_ON_DEMAND_MODE Aufträge erfüllt.

Die Voraussetzungen für einen BITS_JOB_PROPERTY_ON_DEMAND_MODE-Auftrag besteht darin, dass es sich bei der Übertragung um einen 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. Weitere Informationen finden Sie unter HTTP-Anforderungen für BITS-Downloads.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	bits10_1.h (Bits.h einschließen)
Bibliothek	Bits.lib

Weitere Informationen

IBackgroundCopyFile6