structure BG_FILE_PROGRESS (bits.h)

Article
03/01/2024

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.