BG_FILE_PROGRESS-Struktur (bits.h)

Artikel
02/28/2024

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 .

Beachten Sie, dass die Statuswerte wieder auf 0 festgelegt werden, wenn sich der Zeitstempel der URL ändert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Kopfzeile	bits.h

Weitere Informationen

BG_JOB_PROGRESS

BG_JOB_REPLY_PROGRESS

IBackgroundCopyFile::GetProgress

IBackgroundCopyJob3::AddFileWithRanges

Freigeben über