Compartilhar via

Método IDeliveryOptimizationJob::AddFileWithRanges

  • Artigo

Adiciona um arquivo a um trabalho de download e especifica os intervalos do arquivo que você deseja baixar.

Sintaxe

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]

Cadeia de caracteres terminada em nulo que é um identificador exclusivo do conteúdo publicado. Para conteúdo não publicado, essa pode ser qualquer cadeia de caracteres exclusiva que o chamador possa usar para identificar arquivos dentro de um trabalho.

remoteUrl [in]

Cadeia de caracteres terminada em nulo que contém o nome do arquivo no servidor.

localName [in]

Cadeia de caracteres terminada em nulo que contém o nome do arquivo no cliente.

rangeCount [in, opcional]

Número de elementos em Intervalos.

intervalos [in, opcional]

Matriz de uma ou mais estruturas BG_FILE_RANGE que especificam os intervalos a serem baixados. Não especifique intervalos duplicados ou sobrepostos.

fileSize [in, opcional]

Tamanho do arquivo em bytes. Passe DO_UNKNOWN_FILE_SIZE se o tamanho não for conhecido pelo aplicativo chamador.

Valor retornado

Esse método retorna os seguintes valores retornados, bem como outros.

Código de retorno Descrição
S_OK
 Êxito.
E_INVALIDARG
 O nome do arquivo local é NULL ou uma cadeia de caracteres vazia.
E_ACCESSDENIED
 O usuário não tem permissão para gravar no diretório especificado no cliente.
DO_E_INVALID_RANGE
 Um dos intervalos é inválido. Por exemplo, InitialOffset é definido como BG_LENGTH_TO_EOF.
DO_E_OVERLAPPING_RANGES
 Não é possível especificar intervalos duplicados ou sobrepostos.
Nota: Os intervalos são classificados pelo deslocamento do valor, não pelo comprimento. Se forem inseridos intervalos que tenham o mesmo deslocamento, mas estiverem em ordem inversa, esse erro será retornado. Por exemplo, se 100.5 e 100.0 forem inseridos nessa ordem, você não poderá adicionar o arquivo ao trabalho.
DO_E_INVALID_STATE
 O estado do trabalho não pode ser BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server, versão 1709 [somente aplicativos da área de trabalho]
Cabeçalho
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Biblioteca
Dosvc.lib
DLL
Dosvc.dll
IID
 IID_IDeliveryOptimizationJob é definido como EE2584CF-A69C-4848-B633-2649962B3EF7

Confira também

IDeliveryOptimizationJob