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

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.

Exemplos

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

Requisitos

Confira também

IBackgroundCopyCallback3