BG_FILE_PROGRESS Struktur

Die BG_FILE_PROGRESS-Struktur enthält dateibezogene Statusinformationen, z. B. die Anzahl der übertragenen Bytes.

Syntax

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

Member

BytesTotal

Die Länge der Datei in Bytes. Wenn Übermittlungsoptimierung größe der Datei nicht bestimmen kann (z. B. wenn die Datei oder der Server nicht vorhanden ist), wird der Wert DO_UNKNOWN_FILE_SIZE.

Wenn Sie Bereiche aus einer Datei herunterladen, spiegelt BytesTotal die Gesamtzahl der Bytes wider, die Sie aus der Datei herunterladen möchten.

BytesTransferred

Anzahl der übertragenen Bytes.

Abgeschlossen

Bei Downloads ist der Wert TRUE, wenn die Datei für den Benutzer verfügbar ist. andernfalls ist der Wert FALSE. Dateien stehen dem Benutzer nach dem Aufruf der IBackgroundCopyJob::Complete-Methode zur Verfügung. Wenn die Complete-Methode einen vorübergehenden Fehler generiert, sind die Dateien, die vor dem Fehler verarbeitet wurden, für den Benutzer verfügbar. die anderen nicht. Verwenden Sie das Completed-Mitglied, um zu bestimmen, ob die Datei für den Benutzer verfügbar ist, wenn Complete fehlschlägt.

Bemerkungen

Sie können wie Übermittlungsoptimierung, um zu ermitteln, ob die Datei von der Datei übertragen wurde:

  • Vergleichen Sie BytesTransferred mit BytesTotal.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 10 Desktop-Apps, Version 1709 []
Unterstützte Mindestversion (Server)
Windows Server, version 1709 desktop apps only (Nur [ Desktop-Apps der Version 1709)]
Header
Deliveryoptimization.h

Weitere Informationen

BG_JOB_PROGRESS

IBackgroundCopyFile::GetProgress