структура BG_FILE_PROGRESS (bits.h)

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

Синтаксис

typedef struct _BG_FILE_PROGRESS {
  UINT64 BytesTotal;
  UINT64 BytesTransferred;
  BOOL   Completed;
} BG_FILE_PROGRESS;

Члены

BytesTotal

Размер файла в байтах. Если BITS не может определить размер файла (например, если файл или сервер не существует), значение будет BG_SIZE_UNKNOWN.

Если вы загружаете диапазоны из файла, BytesTotal отражает общее количество байтов, которые вы хотите скачать из файла.

BytesTransferred

Число переданных байтов.

Completed

Для скачивания значение равно TRUE , если файл доступен пользователю; в противном случае значение равно FALSE. Файлы доступны пользователю после вызова метода IBackgroundCopyJob::Complete . Если метод Complete создает временную ошибку, эти файлы, обработанные до возникновения ошибки, становятся доступными пользователю; остальные — нет. Используйте элемент Completed , чтобы определить, доступен ли файл пользователю при сбое завершения .

Для отправляемых файлов значение равно TRUE , когда отправка файла завершена; в противном случае значение равно FALSE.

Комментарии

Чтобы определить, передал ли BITS файл, можно:

• Сравните BytesTransferred с BytesTotal.
• Реализуйте обратный вызов IBackgroundCopyCallback2::FileTransferred .

Обратите внимание, что значения хода выполнения будут возвращены в нулевое значение при изменении метки времени URL-адреса.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Минимальная версия сервера	Windows Server 2003
Верхняя часть	bits.h

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

BG_JOB_PROGRESS

BG_JOB_REPLY_PROGRESS

IBackgroundCopyFile::GetProgress

IBackgroundCopyJob3::AddFileWithRanges