Partager via


Méthode IBackgroundCopyQMgr ::CreateGroup (qmgr.h)

[IBackgroundCopyQMgr est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt les interfaces BITS.]

Utilisez la méthode CreateGroup pour créer un groupe et l’ajouter à la file d’attente de téléchargement.

Syntaxe

HRESULT CreateGroup(
  [in]  GUID                 guidGroupID,
  [out] IBackgroundCopyGroup **ppGroup
);

Paramètres

[in] guidGroupID

GUID qui identifie de manière unique le groupe dans la file d’attente de téléchargement.

[out] ppGroup

Pointeur vers un pointeur d’interface IBackgroundCopyGroup . Utilisez cette interface pour gérer le groupe. Par exemple, ajoutez un travail au groupe et définissez les propriétés du groupe.

Valeur retournée

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Code de retour Description
S_OK
Le groupe a été créé.
E_INVALIDARG
Un groupe existe déjà avec ce GUID.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
Plateforme cible Windows
En-tête qmgr.h
DLL QmgrPrxy.dll

Voir aussi

IBackgroundCopyQMgr