Метод IBackgroundCopyFile3::SetValidationState (bits3_0.h)

  • Статья

Задает состояние проверки этого файла.

Синтаксис

HRESULT SetValidationState(
  [in] BOOL state
);

Параметры

[in] state

Задайте значение TRUE , если содержимое файла является допустимым, в противном случае — ЗНАЧЕНИЕ FALSE.

Возвращаемое значение

Метод возвращает следующие возвращаемые значения.

Код возврата Описание
S_OK
 Успешное завершение
E_PENDING
 Вы не сможете проверить файл, пока не завершится скачивание.
BG_E_RECORD_DELETED
 Кэшированная запись, связанная с этим файлом, удалена.

Комментарии

Если для состояния проверки задано значение 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

См. также раздел

IBackgroundCopyFile3

IBackgroundCopyFile3::GetValidationState

IBitsPeerCacheRecord::IsFileValidated