structure BG_FILE_PROGRESS

Article
06/13/2023

La structure BG_FILE_PROGRESS fournit des informations de progression liées aux 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 l’optimisation de la distribution ne peut pas déterminer la taille du fichier (par exemple, si le fichier ou le serveur n’existe pas), la valeur est DO_UNKNOWN_FILE_SIZE.

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.

Terminé

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 .

Notes

Pour déterminer si l’optimisation de la distribution a transféré le fichier, vous pouvez :

Comparez octetsTransferred à BytesTotal.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
En-tête	Deliveryoptimization.h

Voir aussi

BG_JOB_PROGRESS
IBackgroundCopyFile::GetProgress