IBackgroundCopyCallback1 interface (qmgr.h)

[IBackgroundCopyCallback1 is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use the BITS interfaces.]

Implement the IBackgroundCopyCallback1 interface to receive notification when events occur. Applications use this interface as an option to polling for the state of the group.

To receive notifications, call the IBackgroundCopyGroup::SetProp method to set the GROUPPROP_NOTIFYCLSID and GROUPPROP_NOTIFYFLAGS properties.

QMGR uses the interface pointer while it is valid (the interface pointer becomes invalid when your application exits). When your application restarts, you must reset the GROUPPROP_NOTIFYCLSID property on those groups that QMGR is still processing.

Note  QMGR activates the new object inside the scope of the client process; notifications are not run in their own process. QMGR creates a new object of that CLSID and passes an interface pointer to BITS.

 

You must implement all methods of the IBackgroundCopyCallback1 interface. At a minimum, the method must return S_OK. To reduce the chance that your callback blocks BITS, keep your implementation short.

If an administrator takes ownership of the group, the notification callbacks are made in the context of the user who requested notification.

Inheritance

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

Methods

The IBackgroundCopyCallback1 interface has these methods.

IBackgroundCopyCallback1::OnStatus Implement the OnStatus method to receive notification when the group is complete or an error occurs.

Requirements

Requirement	Value
Minimum supported client	Windows XP
Minimum supported server	Windows Server 2003
Target Platform	Windows
Header	qmgr.h