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 |
|