Partager via


Interface IBackgroundCopyJob

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 .

Membres

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.

Méthode Description
Annuler Annule le travail et supprime les fichiers temporaires du client.
Terminé Termine le travail et enregistre les fichiers transférés sur le client.
EnumFiles Retourne un pointeur d’interface vers un objet énumérateur que vous utilisez pour énumérer les fichiers dans le travail.
GetDisplayName Récupère le nom d’affichage qui identifie le travail.
GetError Récupère un pointeur d’interface vers l’objet d’erreur après qu’une erreur s’est produite.
GetId Récupère l’identificateur du travail dans la file d’attente.
GetNoProgressTimeout Récupère la durée pendant laquelle l’optimisation de la distribution continue d’essayer de transférer le fichier après avoir rencontré une condition d’erreur temporaire.
GetNotifyFlags Récupère les indicateurs de notification d’événement (rappel) que vous avez définis pour votre application.
GetNotifyInterface Récupère un pointeur vers votre implémentation de l’interface IBackgroundCopyCallback (rappels).
GetPriority Récupère le niveau de priorité que vous avez défini pour le travail.
GetProgress Récupère les informations de progression liées au travail, telles que le nombre d’octets et de fichiers transférés vers le client.
GetState Récupère l’état du travail.
GetTimes Récupère les horodatages pour les activités liées au travail, telles que l’heure à laquelle le travail a été créé.
GetType Récupère le type de transfert en cours d’exécution, tel qu’un téléchargement de fichier.
Reprendre Démarre un nouveau travail ou redémarre un travail suspendu.
SetNoProgressTimeout Spécifie la durée pendant laquelle l’optimisation de la distribution continue d’essayer de transférer le fichier après avoir rencontré une condition d’erreur temporaire.
SetNotifyFlags Spécifie le type de notification d’événement à recevoir.
SetNotifyInterface Spécifie un pointeur vers votre implémentation de l’interface IBackgroundCopyCallback (rappels). L’interface reçoit une notification en fonction des indicateurs de notification d’événement que vous définissez.
SetPriority Spécifie la priorité du travail par rapport aux autres travaux de la file d’attente de transfert.
Suspendre Interrompt le travail.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server, version 1709 [applications de bureau uniquement]
En-tête
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Bibliothèque
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob est défini comme 37668D37-507E-4160-9316-26306D150B12

Voir aussi

IBackgroundCopyFile

IBackgroundCopyManager