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
Requirement | Value |
---|---|
Minimum supported client | Windows XP |
Minimum supported server | Windows Server 2003 |
Target Platform | Windows |
Header | qmgr.h |
DLL | QmgrPrxy.dll |