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 |
|
| IDL |
|
| Library |
|
| DLL |
|
| IID |
IID_IBackgroundCopyCallback is defined as 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22 |