Метод IBackgroundCopyFile3::SetValidationState (bits3_0.h)
Задает состояние проверки этого файла.
Синтаксис
HRESULT SetValidationState(
[in] BOOL state
);
Параметры
[in] state
Задайте значение TRUE , если содержимое файла является допустимым, в противном случае — ЗНАЧЕНИЕ FALSE.
Возвращаемое значение
Метод возвращает следующие возвращаемые значения.
| Код возврата | Описание |
|---|---|
|
Успешное завершение |
|
Вы не сможете проверить файл, пока не завершится скачивание. |
|
Кэшированная запись, связанная с этим файлом, удалена. |
Комментарии
Если для состояния проверки задано значение FALSE и файл был скачан с сервера-источника, задание перейдет в состояние ошибки с кодом ошибки BG_E_VALIDATION_FAILED а ход выполнения файла будет равен нулю. Затем можно вызвать метод IBackgroundCopyJob::Resume , чтобы скачать файл еще раз.
BITS 3.0: Не вызывайте метод IBackgroundCopyJob::Resume для повторной загрузки файла. Вместо этого вызовите метод IBackgroundCopyJob::Complete или IBackgroundCopyJob::Cancel , чтобы очистить текущее задание, а затем создать новое задание для скачивания файла.
Если для состояния проверки задано значение FALSE и файл был скачан из однорангового узла, BITS удаляет файл из кэша, сбрасывает ход выполнения файла до нуля и снова скачивает файл с сервера-источника.
Этот метод можно вызвать только после того, как BITS завершит передачу файла. Чтобы получать уведомление о завершении передачи, реализуйте метод IBackgroundCopyCallback2::FileTransferred .
Вызов метода IBackgroundCopyJob::Complete неявно проверяет файл.
Если вы проверяете файл в кэше, а затем вызываете метод IBackgroundCopyJob4::SetPeerCachingFlags, чтобы отключить кэширование (или одноранговое кэширование отключается через групповая политика), файл останется в кэше. Если отключить кэширование перед проверкой файла, BITS удалит файл из кэша.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | bits3_0.h (включая Bits.h) |
| Библиотека | Bits.lib |