Compartilhar via

Método IBackgroundCopyCallback3::FileRangesTransferred (bits10_1.h)

  • Artigo

O BITS chama a implementação do método FileRangesTransferred quando um ou mais intervalos de arquivos são baixados. Os intervalos de arquivos são adicionados ao trabalho usando o método IBackgroundCopyFile6::RequestFileRanges .

Sintaxe

HRESULT FileRangesTransferred(
  IBackgroundCopyJob     *job,
  IBackgroundCopyFile    *file,
  DWORD                  rangeCount,
  const BG_FILE_RANGE [] ranges
);

Parâmetros

job

Um objeto IBackgroundCopyJob que contém os métodos para acessar informações de propriedade, progresso e estado do trabalho. Não liberar pJob; O BITS libera a interface quando o método retorna.

file

Um objeto IBackgroundCopyFile que contém informações sobre o arquivo cujos intervalos foram alterados. Não liberar pFile; O BITS libera a interface quando o método retorna.

rangeCount

A contagem de entradas na matriz de intervalos.

ranges

Uma matriz dos intervalos de arquivos que foram transferidos desde a última chamada para FileRangesTransferred ou a última chamada para o método IBackgroundCopyFile6::RequestFileRanges . Não liberar intervalos; O BITS libera a memória de intervalos quando o método FileRangesTransferred retorna.

Retornar valor

Esse método retorna S_OK em caso de êxito; caso contrário, retorna um código de erro.

Comentários

Os intervalos retornados nesse método podem não corresponder aos intervalos solicitados. Isso ocorre porque o BITS não baixará o mesmo intervalo de bytes duas vezes e porque o BITS pode relatar quando parte de um intervalo é baixada.

Sua implementação pode não receber todos os eventos de modificação em condições máximas de carga de recursos.

O BITS gera um alto volume de eventos; considere criar um temporizador e sondagem para informações de estado e progresso ou limitar o uso desse retorno de chamada. Se você usar esse retorno de chamada, mantenha sua implementação curta. Você deve definir a propriedade BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL com o valor mais alto que ainda atende às suas necessidades; isso reduzirá o número de retornos de chamada desnecessários.

Nota O BITS dá suporte a até quatro notificações simultâneas por usuário. Se um ou mais aplicativos bloquearem o retorno de todas as quatro notificações para um usuário, um aplicativo em execução como o mesmo usuário não receberá notificações até que uma ou mais notificações de bloqueio retornem.
 

Exemplos

Para obter um exemplo de como usar essa função, consulte o código de exemplo para a interface IBackgroundCopyCallback3 .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho bits10_1.h (incluir Bits.h)
Biblioteca Bits.lib

Confira também

IBackgroundCopyCallback3