Compartir a través de


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

Devuelve el conjunto de intervalos de archivos que se han descargado.

Sintaxis

HRESULT GetFilledFileRanges(
  [out] DWORD         *rangeCount,
  [out] BG_FILE_RANGE **ranges
);

Parámetros

[out] rangeCount

Número de elementos de Ranges.

[out] ranges

Matriz de estructuras de BG_FILE_RANGE que describen los intervalos que se han descargado. Los intervalos se combinarán tanto como sea posible. Los intervalos se ordenan por desplazamiento. Cuando haya terminado, llame a la función CoTaskMemFree para liberar Ranges.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. El error se E_OUTOFMEMORY si no se pudo asignar la matriz Ranges y BG_E_RANDOM_ACCESS_NOT_SUPPORTED si el trabajo no es un trabajo de descarga o si el servidor pierde su capacidad de admitir intervalos de descarga.

Comentarios

GetFilledFileRanges se puede solicitar para cualquier trabajo de descarga que cumpla también los requisitos de BITS_JOB_PROPERTY_ON_DEMAND_MODE trabajos.

Los requisitos de un trabajo de BITS_JOB_PROPERTY_ON_DEMAND_MODE es que la transferencia debe ser un trabajo DOWNLOAD . El trabajo no debe ser DINÁMICO y el servidor debe ser un servidor HTTP o HTTPS y se deben cumplir todos los requisitos de servidor para la compatibilidad con intervalos. Para obtener más información, vea Requisitos HTTP para descargas de BITS.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1703 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado bits10_1.h (incluya Bits.h)
Library Bits.lib

Consulte también

IBackgroundCopyFile6