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 |
|---|---|
|
Erfolg |
|
Sie können die Datei erst überprüfen, wenn der Download abgeschlossen ist. |
|
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 |