Método IBackgroundCopyFile6::GetFilledFileRanges (bits10_1.h)
Retorna o conjunto de intervalos de arquivos que foram baixados.
Sintaxe
HRESULT GetFilledFileRanges(
[out] DWORD *rangeCount,
[out] BG_FILE_RANGE **ranges
);
Parâmetros
[out] rangeCount
O número de elementos em Intervalos.
[out] ranges
Matriz de estruturas de BG_FILE_RANGE que descreve os intervalos que foram baixados. Os intervalos serão mesclados o máximo possível. Os intervalos são ordenados por deslocamento. Quando terminar, chame a função CoTaskMemFree para liberar Intervalos.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. O erro será E_OUTOFMEMORY se a matriz Intervalos não puder ser alocada e BG_E_RANDOM_ACCESS_NOT_SUPPORTED 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
GetFilledFileRanges pode ser solicitado para qualquer trabalho de download que também atenda aos requisitos para trabalhos de 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.
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 |