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

Article
03/01/2024

[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 GetGroup pour récupérer un groupe à partir de la file d’attente de téléchargement. L’utilisateur actuel peut récupérer uniquement les groupes qu’il possède. Si l’utilisateur dispose de privilèges d’administrateur, il peut récupérer n’importe quel groupe de la file d’attente de téléchargement. La récupération d’un groupe à partir de la file d’attente transfère la propriété du groupe à l’utilisateur actuel.

Syntaxe

HRESULT GetGroup(
  [in]  GUID                 groupID,
  [out] IBackgroundCopyGroup **ppGroup
);

Paramètres

[in] groupID

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é récupéré avec succès.
QM_E_ITEM_NOT_FOUND	Impossible de trouver le groupe dans la file d’attente de téléchargement.

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

Partager via