BG_FILE_PROGRESS-Struktur
Die BG_FILE_PROGRESS-Struktur stellt dateibezogene Statusinformationen bereit, 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 die Übermittlungsoptimierung die 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, gibt BytesTotal die Gesamtanzahl der Bytes an, 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 Auftreten des Fehlers verarbeitet wurden, für den Benutzer verfügbar. die anderen nicht. Verwenden Sie das Member Completed , um zu bestimmen, ob die Datei für den Benutzer verfügbar ist, wenn "Complete" fehlschlägt.
Bemerkungen
Um festzustellen, ob die Datei durch die Übermittlungsoptimierung übertragen wurde, können Sie:
- Vergleichen Sie BytesTransferred mit BytesTotal.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 10, Version 1709 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server, Version 1709 [nur Desktop-Apps] |
| Header |
|