Compartir a través de

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

  • Artículo

Agrega un nuevo conjunto de intervalos de archivos que se van a priorizar para su descarga.

Sintaxis

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

Parámetros

[in] rangeCount

Especifica el tamaño de la matriz Ranges .

[in] ranges

Matriz de intervalos de archivos que se van a descargar. Los intervalos solicitados pueden superponerse a intervalos descargados previamente (o pendientes). Los intervalos se dividen automáticamente en intervalos no superpuestos.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. BG_E_INVALID_RANGE se devuelve si alguna parte del intervalo solicitado está fuera del tamaño real del archivo; BG_E_RANDOM_ACCESS_NOT_SUPPORTED se devuelve si el trabajo no es un trabajo de descarga o si el servidor pierde su capacidad de admitir intervalos de descarga.

Comentarios

RequestFileRanges 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.

Cuando se hayan descargado todos los intervalos solicitados, el estado del trabajo se establecerá en BG_JOB_STATE_TRANSFERRED si se han transferido todos los bytes del archivo. De lo contrario, el estado del trabajo se establecerá en BG_JOB_STATE_SUSPENDED.

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