IBackgroundCopyCallback interface

Implement the IBackgroundCopyCallback interface to receive notification that a job is complete, has been modified, or is in error. Clients use this interface instead of polling for the status of the job.

Members

The IBackgroundCopyCallback interface inherits from the IUnknown interface. IBackgroundCopyCallback also has these types of members:

Methods

The IBackgroundCopyCallback interface has these methods.

Method Description
JobError Called when an error occurs.
JobModification Called when a job is modified.
JobTransferred Called when all of the files in the job have successfully transferred.

Remarks

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.

Delivery Optimization will call your callbacks as long as the interface pointer is valid. The notification interface is no longer valid when your application terminates; Delivery Optimization does not persist the notify interface. As a result, your application's initialization process should call the SetNotifyInterface method on those existing jobs for which you want to receive notification.

Requirements

Requirement Value
Minimum supported client
Windows 10, version 1709 [desktop apps only]
Minimum supported server
Windows Server, version 1709 [desktop apps only]
Header
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Library
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyCallback is defined as 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22

See also

IBackgroundCopyJob

IBackgroundCopyJob::SetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface