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 |