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 |