IBackgroundCopyGroup interface (qmgr.h)

[IBackgroundCopyGroup 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.]

Use the IBackgroundCopyGroup interface to manage a group. A group contains download jobs. For example, add a job to the group, set the properties of the group, and start and stop the group in the download queue.


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


The IBackgroundCopyGroup interface has these methods.


Use the CancelGroup method to remove the group from the queue. Files completely downloaded before calling this method are available to the client. You can cancel a group at anytime; however, the group cannot be recovered once it is canceled.

Use the CreateJob method to add a new job to the group. A group can contain only one job.

Use the EnumJobs method to retrieve a list of jobs in the group. The list contains only one job.

Use the get_GroupID method to retrieve the group's identifier.

Use the get_Size method to retrieve the size of all files in the group to download.

Use the GetJob method to retrieve a job from the group.

Use the GetProgress method to retrieve the progress of the download.

Use the GetProp method to retrieve a property value from the group.

Use the GetStatus method to retrieve the state of the group.

Use the ResumeGroup method to start a group that has been suspended in the download queue.

Use the SetProp method to set the property value for a group property.

Use the SuspendGroup method to pause a group in the download queue. New groups, groups that are in error, or groups that have finished downloading are automatically suspended.

Use the SwitchToForeground method to download the group in the foreground instead of the background.


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