BG_FILE_PROGRESS-Struktur (bits.h)
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 BITS die Größe der Datei nicht ermitteln kann (z. B. wenn die Datei oder der Server nicht vorhanden ist), wird der Wert BG_SIZE_UNKNOWN.
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.
Completed
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 Aufrufen der IBackgroundCopyJob::Complete-Methode zur Verfügung. Wenn die Complete-Methode einen vorübergehenden Fehler generiert, stehen dem Benutzer die Dateien zur Verfügung, die vor dem Auftreten des Fehlers verarbeitet wurden. die anderen nicht. Verwenden Sie das Element Abgeschlossen , um zu bestimmen, ob die Datei für den Benutzer verfügbar ist, wenn Complete fehlschlägt.
Bei Uploads ist der Wert TRUE , wenn der Dateiupload abgeschlossen ist. andernfalls ist der Wert FALSE.
Hinweise
Um zu ermitteln, ob BITS die Datei übertragen hat, können Sie folgendes ausführen:
- Vergleichen Sie BytesTransferred mit BytesTotal.
- Implementieren Sie den IBackgroundCopyCallback2::FileTransferred-Rückruf .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Kopfzeile | bits.h |