Share via

BG_FILE_PROGRESS struttura (bits.h)

  • Articolo

Fornisce informazioni sullo stato di avanzamento correlate ai file, ad esempio il numero di byte trasferiti.

Sintassi

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

Members

BytesTotal

Dimensioni del file, in byte. Se BITS non riesce a determinare le dimensioni del file, ad esempio se il file o il server non esiste, il valore è BG_SIZE_UNKNOWN.

Se si scaricano intervalli da un file, BytesTotal riflette il numero totale di byte che si desidera scaricare dal file.

BytesTransferred

Numero di byte trasferiti.

Completed

Per i download, il valore è TRUE se il file è disponibile per l'utente; in caso contrario, il valore è FALSE. I file sono disponibili per l'utente dopo aver chiamato il metodo IBackgroundCopyJob::Complete . Se il metodo Complete genera un errore temporaneo, tali file elaborati prima dell'errore sono disponibili per l'utente; gli altri non sono. Usare il membro Completato per determinare se il file è disponibile per l'utente quando Completa ha esito negativo.

Per i caricamenti, il valore è TRUE al termine del caricamento del file; in caso contrario, il valore è FALSE.

Commenti

Per determinare se BITS ha trasferito il file, è possibile:

Si noti che i valori di stato verranno impostati su zero se il timestamp dell'URL cambia.

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Intestazione bits.h

Vedi anche

BG_JOB_PROGRESS

BG_JOB_REPLY_PROGRESS

IBackgroundCopyFile::GetProgress

IBackgroundCopyJob3::AddFileWithRanges