Compartilhar via

Método IBackgroundCopyFile6::RequestFileRanges (bits10_1.h)

  • Artigo

Adiciona um novo conjunto de intervalos de arquivos a serem priorizados para download.

Sintaxe

HRESULT RequestFileRanges(
  [in] DWORD                  rangeCount,
  [in] const BG_FILE_RANGE [] ranges
);

Parâmetros

[in] rangeCount

Especifica o tamanho da matriz Intervalos .

[in] ranges

Uma matriz de intervalos de arquivos a serem baixados. Os intervalos solicitados têm permissão para sobrepor intervalos baixados (ou pendentes) anteriormente. Os intervalos são divididos automaticamente em intervalos não sobrepostos.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. BG_E_INVALID_RANGE será retornado se qualquer parte do intervalo solicitado estiver fora do tamanho real do arquivo; BG_E_RANDOM_ACCESS_NOT_SUPPORTED será retornado se o trabalho não for um trabalho de download ou se o servidor perder a capacidade de dar suporte a intervalos de download.

Comentários

RequestFileRanges pode ser solicitado para qualquer trabalho de download que também atenda aos requisitos para trabalhos BITS_JOB_PROPERTY_ON_DEMAND_MODE .

Os requisitos para um trabalho BITS_JOB_PROPERTY_ON_DEMAND_MODE é que a transferência deve ser um trabalho DOWNLOAD . O trabalho não deve ser DYNAMIC e o servidor deve ser um servidor HTTP ou HTTPS e todos os requisitos de servidor para suporte de intervalo devem ser atendidos. Para obter mais informações, consulte Requisitos http para downloads de BITS.

Quando todos os intervalos solicitados tiverem sido baixados, o estado do trabalho será definido como BG_JOB_STATE_TRANSFERRED se todos os bytes do arquivo tiverem sido transferidos. Caso contrário, o estado do trabalho será definido como BG_JOB_STATE_SUSPENDED.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho bits10_1.h (incluir Bits.h)
Biblioteca Bits.lib

Confira também

IBackgroundCopyFile6