IBackgroundCopyCallback3 interface (bits10_1.h)
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.
Inheritance
The IBackgroundCopyCallback3 interface inherits from IBackgroundCopyCallback and IBackgroundCopyCallback2. IBackgroundCopyCallback3 also has these types of members:
Methods
The IBackgroundCopyCallback3 interface has these methods.
| 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. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1703 [desktop apps only] |
| Minimum supported server | Windows Server 2016 [desktop apps only] |
| Target Platform | Windows |
| Header | bits10_1.h (include Bits.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for