IBackgroundCopyCallback3 ::FileRangesTransferred, méthode (bits10_1.h)

Article
02/26/2024

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 .

Syntaxe

HRESULT FileRangesTransferred(
  IBackgroundCopyJob     *job,
  IBackgroundCopyFile    *file,
  DWORD                  rangeCount,
  const BG_FILE_RANGE [] ranges
);

Paramètres

job

Objet IBackgroundCopyJob qui contient les méthodes permettant d’accéder aux informations de propriété, de progression et d’état du travail. Ne pas libérer pJob ; BITS libère l’interface lorsque la méthode retourne.

file

Objet IBackgroundCopyFile qui contient des informations sur le fichier dont les plages ont changé. Ne pas libérer pFile ; BITS libère l’interface lorsque la méthode retourne.

rangeCount

Nombre d’entrées dans le tableau de plages.

ranges

Tableau des plages de fichiers transférées depuis le dernier appel à FileRangesTransferred ou le dernier appel à la méthode IBackgroundCopyFile6 ::RequestFileRanges . Ne pas les plages libres ; BITS libère la mémoire des plages lorsque la méthode FileRangesTransferred retourne.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur.

Remarques

Les plages retournées dans cette méthode peuvent ne pas correspondre aux plages que vous avez demandées. Cela est dû au fait que BITS ne télécharge pas deux fois la même plage d’octets, et parce que BITS peut signaler quand une partie d’une plage est téléchargée.

Votre implémentation peut ne pas recevoir tous les événements de modification dans des conditions de charge maximale des ressources.

BITS génère un volume élevé d’événements ; envisagez de créer un minuteur et d’interroger les informations d’état et de progression ou de limiter votre utilisation de ce rappel. Si vous utilisez ce rappel, gardez votre implémentation courte. Vous devez définir la propriété BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL sur la valeur la plus élevée qui répond toujours à vos besoins ; cela réduira le nombre de rappels inutiles.

Note BITS prend en charge jusqu’à quatre notifications simultanées par utilisateur. Si une ou plusieurs applications bloquent le retour des quatre notifications d’un utilisateur, une application exécutée en tant que même utilisateur ne recevra pas de notifications tant qu’une ou plusieurs notifications de blocage ne seront pas retournées.

Exemples

Pour obtenir un exemple d’utilisation de cette fonction, consultez l’exemple de code de l’interface IBackgroundCopyCallback3 .

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)
Bibliothèque	Bits.lib

Voir aussi

IBackgroundCopyCallback3

Partager via