Partager via

Méthode IBackgroundCopyFile6 ::GetFilledFileRanges (bits10_1.h)

  • Article

Retourne l’ensemble des plages de fichiers qui ont été téléchargées.

Syntaxe

HRESULT GetFilledFileRanges(
  [out] DWORD         *rangeCount,
  [out] BG_FILE_RANGE **ranges
);

Paramètres

[out] rangeCount

Nombre d’éléments dans plages.

[out] ranges

Tableau de structures BG_FILE_RANGE qui décrit les plages qui ont été téléchargées. Les plages seront fusionnées autant que possible. Les plages sont classées par décalage. Lorsque vous avez terminé, appelez la fonction CoTaskMemFree pour libérer des plages.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. L’erreur sera E_OUTOFMEMORY si le tableau Plages n’a pas pu être alloué et BG_E_RANDOM_ACCESS_NOT_SUPPORTED si le travail n’est pas un travail de téléchargement ou si le serveur perd sa capacité à prendre en charge les plages de téléchargement.

Remarques

GetFilledFileRanges peut être demandé pour n’importe quel travail de téléchargement qui répond également aux exigences pour BITS_JOB_PROPERTY_ON_DEMAND_MODE travaux.

La configuration requise pour un travail BITS_JOB_PROPERTY_ON_DEMAND_MODE est que le transfert doit être un travail DOWNLOAD . Le travail ne doit pas être DYNAMIQUE et le serveur doit être un serveur HTTP ou HTTPS et les exigences de serveur pour la prise en charge des plages doivent toutes être satisfaites. Pour plus d’informations, consultez Exigences HTTP pour les téléchargements BITS.

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

IBackgroundCopyFile6