Интерфейс IBackgroundCopyCallback3 (bits10_1.h)

  • Статья

Клиенты реализуют интерфейс IBackgroundCopyCallback3 для получения уведомлений о том, что скачивание диапазонов файлов завершено.

Вместо опроса состояния скачивания файла клиенты используют этот интерфейс. Чтобы получать уведомления, вызовите метод IBackgroundCopyJob::SetNotifyInterface , чтобы указать указатель интерфейса на реализацию IBackgroundCopyCallback . Чтобы указать, какие уведомления вы хотите получать, вызовите метод IBackgroundCopyJob::SetNotifyFlags . Необходимо реализовать все методы этого интерфейса, а также интерфейсы IBackgroundCopyCallback2 и IBackgroundCopyCallback . Например, если вы не зарегистрируетесь для обратного вызова файла, метод FileTransferred должен по-прежнему возвращать S_OK. Если вы не хотите получать обратный вызов диапазонов файлов, можно просто реализовать IBackgroundCopyCallback или IBackgroundCopyCallback2 .

Наследование

Интерфейс IBackgroundCopyCallback3 наследуется от IBackgroundCopyCallback и IBackgroundCopyCallback2. IBackgroundCopyCallback3 также имеет следующие типы элементов:

Методы

Интерфейс IBackgroundCopyCallback3 содержит следующие методы.

 
IBackgroundCopyCallback3::FileRangesTransferred

BITS вызывает реализацию метода FileRangesTransferred при скачивании одного или нескольких диапазонов файлов. Диапазоны файлов добавляются в задание с помощью метода IBackgroundCopyFile6::RequestFileRanges.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1703 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header bits10_1.h (включая Bits.h)

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

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob::SetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface