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 |
|
| IDL |
|
| Bibliothèque |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob est défini comme 37668D37-507E-4160-9316-26306D150B12 |