Compartilhar via


estrutura BG_FILE_PROGRESS (bits.h)

Fornece informações de progresso relacionadas ao arquivo, como o número de bytes transferidos.

Sintaxe

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

Membros

BytesTotal

Tamanho do arquivo em bytes. Se o BITS não puder determinar o tamanho do arquivo (por exemplo, se o arquivo ou o servidor não existir), o valor será BG_SIZE_UNKNOWN.

Se você estiver baixando intervalos de um arquivo, BytesTotal refletirá o número total de bytes que deseja baixar do arquivo.

BytesTransferred

Número de bytes transferidos.

Completed

Para downloads, o valor será TRUE se o arquivo estiver disponível para o usuário; caso contrário, o valor será FALSE. Os arquivos estão disponíveis para o usuário depois de chamar o método IBackgroundCopyJob::Complete . Se o método Complete gerar um erro transitório, esses arquivos processados antes do erro ocorrer estarão disponíveis para o usuário; os outros não são. Use o membro Completed para determinar se o arquivo está disponível para o usuário quando Complete falhar.

Para uploads, o valor é TRUE quando o upload do arquivo é concluído; caso contrário, o valor será FALSE.

Comentários

Para determinar se o BITS transferiu o arquivo, você pode:

Observe que os valores de progresso serão definidos como zero se o carimbo de data/hora da URL for alterado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Cabeçalho bits.h

Confira também

BG_JOB_PROGRESS

BG_JOB_REPLY_PROGRESS

IBackgroundCopyFile::GetProgress

IBackgroundCopyJob3::AddFileWithRanges