IBackgroundCopyFile6::UpdateDownloadPosition-Methode (bits10_1.h)

Gibt eine Position an, aus der das Herunterladen fehlender Daten priorisiert werden soll.

Syntax

HRESULT UpdateDownloadPosition(
  [in] UINT64 offset
);

Parameter

[in] offset

Gibt die neue Position an, aus der das Herunterladen fehlender Daten priorisiert werden soll.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Es wird BG_E_RANDOM_ACCESS_NOT_SUPPORTED zurückgegeben, wenn der Auftrag die Anforderungen eines BITS_JOB_PROPERTY_ON_DEMAND_MODE Auftrags nicht erfüllt.

Hinweise

UpdateDownloadPosition 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.

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