Partager via


IBackgroundCopyFile2 ::GetFileRanges, méthode (bits2_0.h)

Récupère les plages que vous souhaitez télécharger à partir du fichier distant.

Syntaxe

HRESULT GetFileRanges(
  [in, out] DWORD         *RangeCount,
  [out]     BG_FILE_RANGE **Ranges
);

Paramètres

[in, out] RangeCount

Nombre d’éléments dans plages.

[out] Ranges

Tableau de structures BG_FILE_RANGE qui spécifient les plages à télécharger. Lorsque vous avez terminé, appelez la fonction CoTaskMemFree pour libérer des plages.

Valeur retournée

Cette méthode retourne les valeurs de retour suivantes, ainsi que d’autres.

Code de retour Description
S_OK
Succès
S_FALSE
Aucune plage n’a été spécifiée ou le travail est un travail de chargement ou de chargement-réponse. RangeCount a la valeur zéro et Ranges a la valeur NULL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista, Windows XP avec SP2 KB842773 sur Windows Server 2003 et Windows XP
Serveur minimal pris en charge Windows Server 2008, Windows Server 2003 avec SP1
Plateforme cible Windows
En-tête bits2_0.h (include Bits.h)
Bibliothèque Bits.lib
DLL BitsPrx3.dll

Voir aussi

BG_FILE_RANGE

IBackgroundCopyFile2

IBackgroundCopyJob3 ::AddFileWithRanges