IBackgroundCopyQMgr::GetGroup 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 GetGroup method to retrieve a group from the download queue. The current user can retrieve only groups that they own. If the user has Administrator privileges, the user can retrieve any group from the download queue. Retrieving a group from the queue transfers ownership of the group to the current user.
Syntax
HRESULT GetGroup(
[in] GUID groupID,
[out] IBackgroundCopyGroup **ppGroup
);
Parameters
[in] groupID
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 retrieved the group. |
|
Could not find the group in the download queue. |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP |
Minimum supported server | Windows Server 2003 |
Target Platform | Windows |
Header | qmgr.h |
DLL | QmgrPrxy.dll |