Méthode IBackgroundCopyFile6 ::GetFilledFileRanges (bits10_1.h)
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 |