IBackgroundCopyCallback2::FileTransferred-Methode (bits3_0.h)

BITS ruft Ihre Implementierung der FileTransferred-Methode auf, wenn BITS die Übertragung einer Datei erfolgreich abgeschlossen hat.

Syntax

HRESULT FileTransferred(
  [in] IBackgroundCopyJob  *pJob,
  [in] IBackgroundCopyFile *pFile
);

Parameter

[in] pJob

Enthält auftragsbezogene Informationen. Geben Sie pJob nicht frei. BITS gibt die Schnittstelle frei, wenn diese Methode zurückgibt.

[in] pFile

Enthält dateibezogene Informationen. Geben Sie pFile nicht frei. BITS gibt die Schnittstelle frei, wenn diese Methode zurückgibt.

Rückgabewert

Diese Methode sollte S_OK zurückgeben. Andernfalls ruft BITS diese Methode bei negativem Wert weiterhin auf, bis S_OK zurückgegeben wird. Aus Leistungsgründen sollten Sie die Anzahl der Rückgaben eines anderen Werts als S_OK auf einige Male beschränken. Alternativ zum Zurückgeben eines Fehlercodes sollten Sie immer S_OK zurückgeben und den Fehler intern behandeln. Das Intervall, in dem diese Methode aufgerufen wird, ist willkürlich.

Hinweise

In der Regel verwenden Sie diesen Rückruf nur, wenn Sie den Inhalt der heruntergeladenen Datei überprüfen möchten. Die Überprüfung der Datei kann für Sie wichtig sein, wenn Sie Inhalte herunterladen, die an Peers bereitgestellt werden könnten.

Um den Namen der temporären Datei abzurufen, die den heruntergeladenen Inhalt enthält, rufen Sie die IBackgroundCopyFile3::GetTemporaryName-Methode auf. Rufen Sie nach dem Überprüfen des Inhalts die IBackgroundCopyFile3::SetValidationState-Methode auf, um bits anzugeben, ob der Inhalt der Datei gültig ist. Wenn Sie den Überprüfungsstatus auf FALSE festlegen und der Inhalt vom Ursprungsserver stammt, wird der Auftrag in den Fehlerzustand verschoben.

Wenn der Inhalt von einem Peer stammt, lädt BITS die Datei vom Ursprungsserver herunter. Der Rückruf wird erneut aufgerufen, nachdem die Dateiübertragung vom Ursprungsserver abgeschlossen ist.

BITS 3.0: Der Rückruf wird nach Abschluss der Dateiübertragung vom Ursprungsserver nicht mehr aufgerufen.

Für einen Auftrag werden FileTransferred-Rückrufe serialisiert. BITS sendet erst dann einen Rückruf für die nächste Datei im Auftrag, wenn der aktuelle Rückruf erfolgreich zurückgegeben wird.

FileTransferred-Rückrufe werden vor Den Rückrufen von JobTransferred und JobError versendet.

Der FileTransferred-Rückruf dient für Downloadaufträge oder den Antwortteil eines Upload-Antwort-Auftrags.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	bits3_0.h (bits.h einschließen)
Bibliothek	Bits.lib

Weitere Informationen

IBackgroundCopyCallback

IBackgroundCopyCallback2