Interface IBackgroundCopyJob

Article
06/13/2023

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

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