IBackgroundCopyQMgr::CreateGroup method (qmgr.h)
[IBackgroundCopyQMgr 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 CreateGroup method to create a new group and add it to the download queue.
Syntax
HRESULT CreateGroup(
[in] GUID guidGroupID,
[out] IBackgroundCopyGroup **ppGroup
);
Parameters
[in] guidGroupID
GUID that uniquely identifies the group in the download queue.
[out] ppGroup
Pointer to an IBackgroundCopyGroup interface pointer. Use this interface to manage the group. For example, add a job to the group and set the properties of the group.
Return value
This method returns the following HRESULT values, as well as others.
| Return code | Description |
|---|---|
|
Successfully created the group. |
|
A group already exists with that GUID. |
Requirements
| Minimum supported client | Windows XP |
| Minimum supported server | Windows Server 2003 |
| Target Platform | Windows |
| Header | qmgr.h |
| DLL | QmgrPrxy.dll |