IBackgroundCopyCallback3::FileRangesTransferred-Methode (bits10_1.h)

Artikel
08/22/2023

BITS ruft Ihre Implementierung der FileRangesTransferred-Methode auf , wenn mindestens ein Dateibereich heruntergeladen wurde. Dateibereiche werden dem Auftrag mithilfe der IBackgroundCopyFile6::RequestFileRanges-Methode hinzugefügt.

Syntax

HRESULT FileRangesTransferred(
  IBackgroundCopyJob     *job,
  IBackgroundCopyFile    *file,
  DWORD                  rangeCount,
  const BG_FILE_RANGE [] ranges
);

Parameter

job

Ein IBackgroundCopyJob-Objekt , das die Methoden für den Zugriff auf Eigenschaften-, Status- und Zustandsinformationen des Auftrags enthält. Geben Sie pJob nicht frei; BITS gibt die -Schnittstelle frei, wenn die -Methode zurückgibt.

file

Ein IBackgroundCopyFile-Objekt , das Informationen zu der Datei enthält, deren Bereiche geändert wurden. PFile nicht freigeben; BITS gibt die -Schnittstelle frei, wenn die -Methode zurückgibt.

rangeCount

Die Anzahl der Einträge im Bereichsarray.

ranges

Ein Array der Dateibereiche, die seit dem letzten Aufruf von FileRangesTransferred oder dem letzten Aufruf der IBackgroundCopyFile6::RequestFileRanges-Methode übertragen wurden. Keine Freien Bereiche; BITS gibt den Bereichsspeicher frei, wenn die FileRangesTransferred-Methode zurückgibt.

Rückgabewert

Diese Methode gibt S_OK nach Erfolg zurück. Gibt andernfalls einen Fehlercode zurück.

Hinweise

Die in dieser Methode zurückgegebenen Bereiche stimmen möglicherweise nicht mit den angeforderten Bereichen überein. Dies liegt daran, dass BITS denselben Bytebereich nicht zweimal herunterladen wird und WEIL BITS melden kann, wenn ein Teil eines Bereichs heruntergeladen wird.

Ihre Implementierung empfängt möglicherweise nicht alle Änderungsereignisse unter bedingungen der maximalen Ressourcenauslastung.

BITS generiert eine große Anzahl von Ereignissen. Erwägen Sie, einen Timer zu erstellen und Status- und Statusinformationen abzurufen, oder beschränken Sie die Verwendung dieses Rückrufs. Wenn Sie diesen Rückruf verwenden, halten Sie Ihre Implementierung kurz. Sie sollten die BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL-Eigenschaft auf den höchsten Wert festlegen, der Ihren Anforderungen noch entspricht. Dadurch wird die Anzahl der nicht benötigten Rückrufe reduziert.

Hinweis BITS unterstützt bis zu vier gleichzeitige Benachrichtigungen pro Benutzer. Wenn eine oder mehrere Anwendungen die Rückgabe aller vier Benachrichtigungen für einen Benutzer blockieren, erhält eine Anwendung, die als derselbe Benutzer ausgeführt wird, erst dann Benachrichtigungen, wenn mindestens eine der blockierenden Benachrichtigungen zurückgegeben wird.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie im Beispielcode für die IBackgroundCopyCallback3-Schnittstelle .

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

IBackgroundCopyCallback3

Freigeben über