Share via


Interface IBackgroundCopyCallback3 (bits10_1.h)

Les clients implémentent l’interface IBackgroundCopyCallback3 pour recevoir une notification indiquant que le téléchargement des plages d’un fichier est terminé.

Au lieu d’interroger les status de téléchargement d’un fichier, les clients utilisent cette interface. Pour recevoir des notifications, appelez la méthode IBackgroundCopyJob ::SetNotifyInterface pour spécifier le pointeur d’interface vers votre implémentation IBackgroundCopyCallback . Pour spécifier les notifications que vous souhaitez recevoir, appelez la méthode IBackgroundCopyJob ::SetNotifyFlags . Vous devez implémenter toutes les méthodes de cette interface et les interfaces IBackgroundCopyCallback2 et IBackgroundCopyCallback . Par exemple, si vous ne vous inscrivez pas au rappel transféré de fichier, votre méthode FileTransferred doit toujours retourner S_OK. Si vous ne souhaitez pas recevoir le rappel transféré des plages de fichiers, vous pouvez simplement implémenter IBackgroundCopyCallback ou IBackgroundCopyCallback2 à la place.

Héritage

L’interface IBackgroundCopyCallback3 hérite de IBackgroundCopyCallback et IBackgroundCopyCallback2. IBackgroundCopyCallback3 a également les types de membres suivants :

Méthodes

L’interface IBackgroundCopyCallback3 utilise ces méthodes.

 
IBackgroundCopyCallback3 ::FileRangesTransferred

BITS appelle votre implémentation de la méthode FileRangesTransferred quand une ou plusieurs plages de fichiers ont été téléchargées. Les plages de fichiers sont ajoutées au travail à l’aide de la méthode IBackgroundCopyFile6 ::RequestFileRanges.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1703 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête bits10_1.h (include Bits.h)

Voir aussi

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob ::SetNotifyFlags

IBackgroundCopyJob ::SetNotifyInterface