Méthode IBackgroundCopyFile6 ::RequestFileRanges (bits10_1.h)
Ajoute un nouvel ensemble de plages de fichiers à hiérarchiser pour le téléchargement.
Syntaxe
HRESULT RequestFileRanges(
[in] DWORD rangeCount,
[in] const BG_FILE_RANGE [] ranges
);
Paramètres
[in] rangeCount
Spécifie la taille du tableau Ranges .
[in] ranges
Tableau de plages de fichiers à télécharger. Les plages demandées sont autorisées à chevaucher les plages précédemment téléchargées (ou en attente). Les plages sont automatiquement divisées en plages qui ne se chevauchent pas.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. BG_E_INVALID_RANGE est retourné si une partie de la plage demandée est en dehors de la taille de fichier réelle ; BG_E_RANDOM_ACCESS_NOT_SUPPORTED est retourné 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
RequestFileRanges 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 de 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 du serveur pour la prise en charge de la plage doivent toutes être remplies. Pour plus d’informations, consultez Exigences HTTP pour les téléchargements BITS.
Lorsque toutes les plages demandées ont été téléchargées, l’état du travail est défini sur BG_JOB_STATE_TRANSFERRED si tous les octets du fichier ont été transférés. Sinon, l’état du travail est défini sur BG_JOB_STATE_SUSPENDED.
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 (inclure Bits.h) |
| Bibliothèque | Bits.lib |