структура 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 .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP |
| Минимальная версия сервера | Windows Server 2003 |
| Верхняя часть | bits.h |