Compartilhar via


Método IDODownload::Start (deliveryoptimization.h)

Inicia ou retoma um download, passando intervalos opcionais como um ponteiro para DO_DOWNLOAD_RANGES_INFO estrutura.

Sintaxe

HRESULT Start(
  const DO_DOWNLOAD_RANGES_INFO *ranges
);

Parâmetros

ranges

Opcional. Um ponteiro para uma estrutura de DO_DOWNLOAD_RANGES_INFO (para baixar apenas intervalos específicos do arquivo). O valor passado aqui indica se o download é para todo o arquivo ou intervalos parciais dentro do arquivo ou simplesmente para retomar o download sem alterar as informações de intervalos. Uma solicitação para baixar todo o arquivo é indicada passando um ponteiro para uma estrutura de DO_DOWNLOAD_RANGES_INFO vazia, ou seja, com seu membro RangeCount definido como zero. Uma solicitação para baixar um arquivo parcial é indicada passando um ponteiro para uma estrutura de DO_DOWNLOAD_RANGES_INFO não vazia. A passagem nullptr é permitida somente quando o download já foi iniciado uma vez antes com intervalos vazios/não vazios e indica que o download deve ser retomado sem nenhuma alteração nos intervalos solicitados.

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erroHRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11 Build 22621
Cabeçalho deliveryoptimization.h