Метод IBackgroundCopyCallback2::FileTransferred (bits3_0.h)

Статья
08/22/2023

BITS вызывает реализацию метода FileTransferred , когда BITS успешно завершает передачу файла.

Синтаксис

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

Параметры

[in] pJob

Содержит сведения, связанные с заданием. Не выпускайте pJob; BITS освобождает интерфейс при возврате этим методом.

[in] pFile

Содержит сведения, связанные с файлами. Не выпускайте pFile; BITS освобождает интерфейс при возврате этим методом.

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

Этот метод должен возвращать S_OK; В противном случае bits продолжает вызывать этот метод до тех пор, пока не будет возвращен S_OK . Из соображений производительности следует ограничить количество возвращаемых значений, отличных от S_OK , несколькими значениями. В качестве альтернативы возврату кода ошибки рекомендуется всегда возвращать S_OK и обрабатывать ошибку внутри системы. Интервал вызова этого метода является произвольным.

Как правило, вы не используете этот обратный вызов, если не хотите проверить содержимое скачаемого файла. Проверка файла может быть важна для вас, если вы скачиваете содержимое, которое может быть показано одноранговым узлам.

Чтобы получить имя временного файла, содержащего скачанный контент, вызовите метод IBackgroundCopyFile3::GetTemporaryName . После проверки содержимого вызовите метод IBackgroundCopyFile3::SetValidationState , чтобы указать BITS, является ли содержимое файла допустимым. Если для состояния проверки задано значение FALSE , а содержимое — с сервера-источника, задание переместится в состояние ошибки.

Если содержимое из однорангового узла, BITS скачивает файл с сервера-источника. Обратный вызов вызывается снова после завершения передачи файлов с сервера-источника.

BITS 3.0: Обратный вызов больше не вызывается после завершения передачи файлов с сервера-источника.

Для задания сериализуются обратные вызовы FileTransferred . BITS не будет отправлять обратный вызов для следующего файла в задании, пока текущий обратный вызов не будет успешно возвращен.

Обратные вызовы FileTransferred отправляются до обратных вызовов JobTransferred и JobError.

Обратный вызов FileTransferred предназначен для заданий скачивания или ответной части задания upload-reply.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	bits3_0.h (включая Bits.h)
Библиотека	Bits.lib

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

IBackgroundCopyCallback

IBackgroundCopyCallback2