Partager via


Interface IBackgroundCopyJob (bits.h)

Utilisez l’interface IBackgroundCopyJob pour ajouter des fichiers au travail, définir le niveau de priorité du travail, déterminer l’état du travail et démarrer et arrêter le travail.

Pour créer un travail, appelez la méthode IBackgroundCopyManager ::CreateJob . Pour obtenir un pointeur d’interface IBackgroundCopyJob vers un travail existant, appelez la méthode IBackgroundCopyManager ::GetJob .

Héritage

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

Méthodes

L’interface IBackgroundCopyJob possède ces méthodes.

 
IBackgroundCopyJob ::AddFile

Ajoute un seul fichier au travail.
IBackgroundCopyJob ::AddFileSet

Ajoute plusieurs fichiers à un travail.
IBackgroundCopyJob ::Cancel

Supprime le travail de la file d’attente de transfert et supprime les fichiers temporaires associés du client (téléchargements) et du serveur (chargements).
IBackgroundCopyJob ::Complete

Termine le travail et enregistre les fichiers transférés sur le client.
IBackgroundCopyJob ::EnumFiles

Récupère un pointeur d’interface IEnumBackgroundCopyFiles que vous utilisez pour énumérer les fichiers dans un travail.
IBackgroundCopyJob ::GetDescription

Récupère la description du travail.
IBackgroundCopyJob ::GetDisplayName

Récupère le nom d’affichage du travail. En règle générale, vous utilisez le nom d’affichage pour identifier le travail dans une interface utilisateur.
IBackgroundCopyJob ::GetError

Récupère l’interface d’erreur après qu’une erreur s’est produite.
IBackgroundCopyJob ::GetErrorCount

Récupère le nombre de fois où BITS a tenté de transférer le travail et qu’une erreur s’est produite.
IBackgroundCopyJob ::GetId

Récupère l’identificateur utilisé pour identifier le travail dans la file d’attente.
IBackgroundCopyJob ::GetMinimumRetryDelay

Récupère la durée minimale d’attente du service après avoir rencontré une condition d’erreur temporaire avant d’essayer de transférer le fichier.
IBackgroundCopyJob ::GetNoProgressTimeout

Récupère la durée pendant laquelle le service tente de transférer le fichier après qu’une condition d’erreur temporaire se produit. En cas de progression, le minuteur est réinitialisé.
IBackgroundCopyJob ::GetNotifyFlags

Récupère les indicateurs de notification d’événement pour le travail.
IBackgroundCopyJob ::GetNotifyInterface

Récupère le pointeur d’interface vers votre implémentation de l’interface IBackgroundCopyCallback.
IBackgroundCopyJob ::GetOwner

Récupère l’identité du propriétaire du travail.
IBackgroundCopyJob ::GetPriority

Récupère le niveau de priorité du travail. Le niveau de priorité détermine quand le travail est traité par rapport aux autres travaux de la file d’attente de transfert.
IBackgroundCopyJob ::GetProgress

Récupère les informations de progression liées au travail, telles que le nombre d’octets et de fichiers transférés.
IBackgroundCopyJob ::GetProxySettings

Récupère les informations de proxy que le travail utilise pour transférer les fichiers.
IBackgroundCopyJob ::GetState

Récupère l’état du travail.
IBackgroundCopyJob ::GetTimes

Récupère les horodatages liés au travail, tels que l’heure de création ou de dernière modification du travail.
IBackgroundCopyJob ::GetType

Récupère le type de transfert en cours d’exécution, tel qu’un téléchargement ou un chargement de fichier.
IBackgroundCopyJob ::Resume

Active un nouveau travail ou redémarre un travail qui a été suspendu.
IBackgroundCopyJob ::SetDescription

Fournit une description du travail.
IBackgroundCopyJob ::SetDisplayName

Spécifie un nom d’affichage pour le travail. En règle générale, vous utilisez le nom d’affichage pour identifier le travail dans une interface utilisateur.
IBackgroundCopyJob ::SetMinimumRetryDelay

Définit la durée minimale d’attente de BITS après avoir rencontré une condition d’erreur temporaire avant d’essayer de transférer le fichier.
IBackgroundCopyJob ::SetNoProgressTimeout

Définit la durée pendant laquelle BITS tente de transférer le fichier après qu’une condition d’erreur temporaire se produit. En cas de progression, le minuteur est réinitialisé.
IBackgroundCopyJob ::SetNotifyFlags

Spécifie le type de notification d’événement que vous souhaitez recevoir, comme les événements transférés par le travail.
IBackgroundCopyJob ::SetNotifyInterface

Identifie votre implémentation de l’interface IBackgroundCopyCallback sur BITS. Utilisez l’interface IBackgroundCopyCallback pour recevoir une notification des événements liés au travail.
IBackgroundCopyJob ::SetPriority

Spécifie le niveau de priorité de votre travail. Le niveau de priorité détermine quand votre travail est traité par rapport aux autres travaux de la file d’attente de transfert.
IBackgroundCopyJob ::SetProxySettings

Spécifie le proxy à utiliser pour transférer des fichiers.
IBackgroundCopyJob ::Suspend

Suspend un travail. Les nouveaux travaux, les travaux qui sont en erreur et les travaux qui ont terminé le transfert de fichiers sont automatiquement suspendus.
IBackgroundCopyJob ::TakeOwnership

Change la propriété du travail à l’utilisateur actuel.

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 bits.h

Voir aussi

IBackgroundCopyFile

IBackgroundCopyJob2

IBackgroundCopyJob3

IBackgroundCopyManager

IEnumBackgroundCopyJobs