Partager via

structure BG_FILE_PROGRESS (bits.h)

  • Article

Fournit des informations sur la progression des fichiers, telles que le nombre d’octets transférés.

Syntaxe

typedef struct _BG_FILE_PROGRESS {
  UINT64 BytesTotal;
  UINT64 BytesTransferred;
  BOOL   Completed;
} BG_FILE_PROGRESS;

Membres

BytesTotal

Taille du fichier en octets. Si BITS ne peut pas déterminer la taille du fichier (par exemple, si le fichier ou le serveur n’existe pas), la valeur est BG_SIZE_UNKNOWN.

Si vous téléchargez des plages à partir d’un fichier, BytesTotal reflète le nombre total d’octets que vous souhaitez télécharger à partir du fichier.

BytesTransferred

Nombre d’octets transférés.

Completed

Pour les téléchargements, la valeur est TRUE si le fichier est disponible pour l’utilisateur ; sinon, la valeur est FALSE. Les fichiers sont disponibles pour l’utilisateur après avoir appelé la méthode IBackgroundCopyJob ::Complete . Si la méthode Complete génère une erreur temporaire, ces fichiers traités avant que l’erreur ne se produise sont disponibles pour l’utilisateur ; les autres ne le sont pas. Utilisez le membre Terminé pour déterminer si le fichier est disponible pour l’utilisateur en cas d’échec de l’exécution .

Pour les chargements, la valeur est TRUE lorsque le chargement du fichier est terminé ; sinon, la valeur est FALSE.

Remarques

Pour déterminer si BITS a transféré le fichier, vous pouvez :

Notez que les valeurs de progression seront rétablies à zéro si l’horodatage de l’URL change.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
En-tête bits.h

Voir aussi

BG_JOB_PROGRESS

BG_JOB_REPLY_PROGRESS

IBackgroundCopyFile ::GetProgress

IBackgroundCopyJob3 ::AddFileWithRanges