Freigeben über


IBackgroundCopyFile3::SetValidationState-Methode (bits3_0.h)

Legt den Überprüfungsstatus dieser Datei fest.

Syntax

HRESULT SetValidationState(
  [in] BOOL state
);

Parameter

[in] state

Legen Sie auf TRUE fest, wenn der Dateiinhalt gültig ist, andernfalls FALSE.

Rückgabewert

Die -Methode gibt die folgenden Rückgabewerte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg
E_PENDING
Sie können die Datei erst überprüfen, wenn der Download abgeschlossen ist.
BG_E_RECORD_DELETED
Der dieser Datei zugeordnete zwischengespeicherte Datensatz wurde gelöscht.

Hinweise

Wenn Sie den Überprüfungsstatus auf FALSE festlegen und die Datei vom Ursprungsserver heruntergeladen wurde, wechselt der Auftrag in den Fehlerzustand mit dem Fehlercode BG_E_VALIDATION_FAILED und der Dateistatus wird auf Null festgelegt. Sie können dann die IBackgroundCopyJob::Resume-Methode aufrufen, um die Datei erneut herunterzuladen.

BITS 3.0: Rufen Sie nicht die IBackgroundCopyJob::Resume-Methode auf, um die Datei erneut herunterzuladen. Rufen Sie stattdessen die Methode IBackgroundCopyJob::Complete oder IBackgroundCopyJob::Cancel auf, um den aktuellen Auftrag zu bereinigen und dann einen neuen Auftrag zum Herunterladen der Datei zu erstellen.

Wenn Sie den Überprüfungsstatus auf FALSE festlegen und die Datei von einem Peer heruntergeladen wurde, entfernt BITS die Datei aus dem Cache, setzt den Dateifortschritt auf Null zurück und lädt die Datei erneut vom Ursprungsserver herunter.

Sie können diese Methode erst aufrufen, nachdem BITS die Übertragung der Datei abgeschlossen hat. Um eine Benachrichtigung zu erhalten, wenn die Übertragung abgeschlossen ist, implementieren Sie die IBackgroundCopyCallback2::FileTransferred-Methode .

Durch Aufrufen der IBackgroundCopyJob::Complete-Methode wird die Datei implizit überprüft.

Wenn Sie eine Datei im Cache überprüfen und dann IBackgroundCopyJob4::SetPeerCachingFlags aufrufen, um die Zwischenspeicherung zu deaktivieren (oder die Peerzwischenspeicherung über Gruppenrichtlinie deaktiviert wird), verbleibt die Datei im Cache. Wenn Sie die Zwischenspeicherung vor dem Überprüfen der Datei deaktivieren, entfernt BITS die Datei aus dem Cache.

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

IBackgroundCopyFile3

IBackgroundCopyFile3::GetValidationState

IBitsPeerCacheRecord::IsFileValidated