IBackgroundCopyFile6::RequestFileRanges-Methode (bits10_1.h)
Fügt eine neue Gruppe von Dateibereichen hinzu, die für den Download priorisiert werden sollen.
Syntax
HRESULT RequestFileRanges(
[in] DWORD rangeCount,
[in] const BG_FILE_RANGE [] ranges
);
Parameter
[in] rangeCount
Gibt die Größe des Ranges-Arrays an.
[in] ranges
Ein Array von Dateibereichen, die heruntergeladen werden sollen. Angeforderte Bereiche dürfen zuvor heruntergeladene (oder ausstehende) Bereiche überlappen. Bereiche werden automatisch in nicht überlappende Bereiche aufgeteilt.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. BG_E_INVALID_RANGE wird zurückgegeben, wenn ein Teil des angeforderten Bereichs außerhalb der tatsächlichen Dateigröße liegt. BG_E_RANDOM_ACCESS_NOT_SUPPORTED wird zurückgegeben, wenn der Auftrag kein Downloadauftrag ist oder wenn der Server nicht mehr in der Lage ist, Downloadbereiche zu unterstützen.
Hinweise
RequestFileRanges kann für jeden Downloadauftrag angefordert werden, der auch die Anforderungen für BITS_JOB_PROPERTY_ON_DEMAND_MODE Aufträge erfüllt.
Die Anforderungen für einen BITS_JOB_PROPERTY_ON_DEMAND_MODE Auftrag sind, dass die Übertragung ein DOWNLOAD-Auftrag sein muss. 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.
Wenn alle angeforderten Bereiche heruntergeladen wurden, wird der Auftragsstatus auf BG_JOB_STATE_TRANSFERRED festgelegt, wenn alle Bytes der Datei übertragen wurden. Andernfalls wird der Auftragsstatus auf BG_JOB_STATE_SUSPENDED festgelegt.
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 |