Compartir a través de

IDeliveryOptimizationJob::AddFileWithRanges (método)

  • Artículo

Agrega un archivo a un trabajo de descarga y especifica los intervalos del archivo que desea descargar.

Sintaxis

HRESULT AddFileWithRanges(
  [in]           LPCWSTR       fileId,
  [in]           LPCWSTR       remoteUrl,
  [in]           LPCWSTR       localName,
  [in, optional] DWORD         rangeCount,
  [in, optional] BG_FILE_RANGE ranges[],
  [in, optional] ULONG64       fileSize
);

Parámetros

fileId [in]

Cadena terminada en null que es un identificador único del contenido publicado. En el caso del contenido no publicado, puede ser cualquier cadena única que el autor de la llamada pueda usar para identificar archivos dentro de un trabajo.

remoteUrl [in]

Cadena terminada en NULL que contiene el nombre del archivo en el servidor.

localName [in]

Cadena terminada en NULL que contiene el nombre del archivo en el cliente.

rangeCount [in, opcional]

Número de elementos de Ranges.

ranges [in, optional]

Matriz de una o varias estructuras de BG_FILE_RANGE que especifican los intervalos que se van a descargar. No especifique intervalos duplicados o superpuestos.

fileSize [in, optional]

Tamaño del archivo en bytes. Pase DO_UNKNOWN_FILE_SIZE si no se conoce el tamaño de la aplicación que llama.

Valor devuelto

Este método devuelve los siguientes valores devueltos, así como otros.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 El nombre de archivo local es NULL o cadena vacía.
E_ACCESSDENIED
 El usuario no tiene permiso para escribir en el directorio especificado en el cliente.
DO_E_INVALID_RANGE
 Uno de los intervalos no es válido. Por ejemplo, InitialOffset se establece en BG_LENGTH_TO_EOF.
DO_E_OVERLAPPING_RANGES
 No se pueden especificar intervalos duplicados o superpuestos.
Nota: Los intervalos se ordenan por el desplazamiento del valor, no por la longitud. Si se especifican intervalos que tienen el mismo desplazamiento, pero están en orden inverso, se devolverá este error. Por ejemplo, si se especifican 100.5 y 100.0 en ese orden, no podrá agregar el archivo al trabajo.
DO_E_INVALID_STATE
 El estado del trabajo no puede ser BG_JOB_STATE_CANCELLED ni BG_JOB_STATE_ACKNOWLEDGED.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 10, versión 1709 [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server, versión 1709 [solo aplicaciones de escritorio]
Encabezado
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Biblioteca
Dosvc.lib
Archivo DLL
Dosvc.dll
IID
 IID_IDeliveryOptimizationJob se define como EE2584CF-A69C-4848-B633-2649962B3EF7

Consulte también

IDeliveryOptimizationJob