Partager via


Méthode IDODownload ::Start (deliveryoptimization.h)

Démarre ou reprend un téléchargement, en passant des plages facultatives comme pointeur vers DO_DOWNLOAD_RANGES_INFO structure.

Syntaxe

HRESULT Start(
  const DO_DOWNLOAD_RANGES_INFO *ranges
);

Paramètres

ranges

Facultatif. Pointeur vers une structure DO_DOWNLOAD_RANGES_INFO (pour télécharger uniquement des plages spécifiques du fichier). La valeur passée ici indique si le téléchargement concerne l’intégralité du fichier ou des plages partielles dans le fichier ou simplement pour reprendre le téléchargement sans modifier les informations des plages. Une demande de téléchargement du fichier entier est indiquée en passant un pointeur vers une structure DO_DOWNLOAD_RANGES_INFO vide, c’est-à-dire avec son membre RangeCount défini sur zéro. Une demande de téléchargement d’un fichier partiel est indiquée en passant un pointeur vers une structure de DO_DOWNLOAD_RANGES_INFO non vide. La transmission nullptr n’est autorisée que lorsque le téléchargement a déjà démarré une fois auparavant avec des plages vides/non vides, et indique que le téléchargement doit reprendre sans aucune modification des plages demandée.

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreurHRESULT.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 11 Build 22621
En-tête deliveryoptimization.h