Interface IBackgroundCopyGroup (qmgr.h)

[IBackgroundCopyGroup 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 l’interface IBackgroundCopyGroup pour gérer un groupe. Un groupe contient des travaux de téléchargement. Par exemple, ajoutez un travail au groupe, définissez les propriétés du groupe et démarrez et arrêtez le groupe dans la file d’attente de téléchargement.

Héritage

L’interface IBackgroundCopyGroup hérite de l’interface IUnknown. IBackgroundCopyGroup a également les types de membres suivants :

Méthodes

L’interface IBackgroundCopyGroup comporte ces méthodes.

IBackgroundCopyGroup ::CancelGroup Utilisez la méthode CancelGroup pour supprimer le groupe de la file d’attente. Les fichiers entièrement téléchargés avant d’appeler cette méthode sont disponibles pour le client. Vous pouvez annuler un groupe à tout moment ; toutefois, le groupe ne peut pas être récupéré une fois qu’il est annulé.
IBackgroundCopyGroup ::CreateJob Utilisez la méthode CreateJob pour ajouter un nouveau travail au groupe. Un groupe ne peut contenir qu’un seul travail.
IBackgroundCopyGroup ::EnumJobs Utilisez la méthode EnumJobs pour récupérer une liste de travaux dans le groupe. La liste ne contient qu’un seul travail.
IBackgroundCopyGroup ::get_GroupID Utilisez la méthode get_GroupID pour récupérer l’identificateur du groupe.
IBackgroundCopyGroup ::get_Size Utilisez la méthode get_Size pour récupérer la taille de tous les fichiers du groupe à télécharger.
IBackgroundCopyGroup ::GetJob Utilisez la méthode GetJob pour récupérer un travail à partir du groupe.
IBackgroundCopyGroup ::GetProgress Utilisez la méthode GetProgress pour récupérer la progression du téléchargement.
IBackgroundCopyGroup ::GetProp Utilisez la méthode GetProp pour récupérer une valeur de propriété à partir du groupe.
IBackgroundCopyGroup ::GetStatus Utilisez la méthode GetStatus pour récupérer l’état du groupe.
IBackgroundCopyGroup ::ResumeGroup Utilisez la méthode ResumeGroup pour démarrer un groupe qui a été suspendu dans la file d’attente de téléchargement.
IBackgroundCopyGroup ::SetProp Utilisez la méthode SetProp pour définir la valeur de la propriété d’une propriété de groupe.
IBackgroundCopyGroup ::SuspendGroup Utilisez la méthode SuspendGroup pour suspendre un groupe dans la file d’attente de téléchargement. Les nouveaux groupes, les groupes qui sont en erreur ou les groupes qui ont terminé le téléchargement sont automatiquement suspendus.
IBackgroundCopyGroup ::SwitchToForeground Utilisez la méthode SwitchToForeground pour télécharger le groupe au premier plan au lieu de l’arrière-plan.

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