IBackgroundCopyCallback3 interface

Clients implement the IBackgroundCopyCallback3 interface to receive notification that ranges of a file have completed downloading.

Instead of polling for the download status of a file, clients use this interface. To receive notifications, call the IBackgroundCopyJob::SetNotifyInterface method to specify the interface pointer to your IBackgroundCopyCallback implementation. To specify which notifications you want to receive, call the IBackgroundCopyJob::SetNotifyFlags method. You must implement all methods of this interface and the IBackgroundCopyCallback2 and IBackgroundCopyCallback interface. For example, if you do not register for the file transferred callback, your FileTransferred method must still return S_OK. If you do not want to receive the file ranges transferred callback, you can simply implement the IBackgroundCopyCallback or IBackgroundCopyCallback2 instead.


The IBackgroundCopyCallback3 interface has these methods.

Method Description
IBackgroundCopyCallback3::FileRangesTransferred BITS calls your implementation of the FileRangesTransferred method when one or more file ranges have been downloaded. File ranges are added to the job using the IBackgroundCopyFile6::RequestFileRanges method.


Windows version Windows 10, version 1703 [desktop apps only] Windows Server 2016 [desktop apps only]
Target Platform Windows
Header bits10_1.h (include Bits.h)

See Also