Edit

IBackgroundCopyQMgr::CreateGroup method (qmgr.h)

  • Article

[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
S_OK
 Successfully created the group.
E_INVALIDARG
 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

See also

IBackgroundCopyQMgr