Método IBackgroundCopyCallback2::FileTransferred (bits3_0.h)

O BITS chama a implementação do método FileTransferred quando o BITS termina com êxito a transferência de um arquivo.

Sintaxe

HRESULT FileTransferred(
  [in] IBackgroundCopyJob  *pJob,
  [in] IBackgroundCopyFile *pFile
);

Parâmetros

[in] pJob

Contém informações relacionadas ao trabalho. Não liberar pJob; O BITS libera a interface quando esse método retorna.

[in] pFile

Contém informações relacionadas ao arquivo. Não liberar pFile; O BITS libera a interface quando esse método retorna.

Retornar valor

Esse método deve retornar S_OK; caso contrário, se negativo, o BITS continuará a chamar esse método até que S_OK seja retornado. Por motivos de desempenho, você deve limitar o número de vezes que retorna um valor diferente de S_OK para algumas vezes. Como alternativa para retornar um código de erro, considere sempre retornar S_OK e lidar com o erro internamente. O intervalo no qual esse método é chamado é arbitrário.

Comentários

Normalmente, você não usaria esse retorno de chamada, a menos que queira validar o conteúdo do arquivo que foi baixado. Validar o arquivo pode ser importante para você se você estiver baixando conteúdo que pode ser servido aos pares.

Para obter o nome do arquivo temporário que contém o conteúdo baixado, chame o método IBackgroundCopyFile3::GetTemporaryName . Depois de verificar o conteúdo, chame o método IBackgroundCopyFile3::SetValidationState para indicar ao BITS se o conteúdo do arquivo for válido. Se você definir o estado de validação como FALSE e o conteúdo for do servidor de origem, o trabalho passará para o estado de erro.

Se o conteúdo for de um par, o BITS baixará o arquivo do servidor de origem. O retorno de chamada é chamado novamente após a conclusão da transferência de arquivo do servidor de origem.

BITS 3.0: O retorno de chamada não é chamado novamente após a conclusão da transferência de arquivo do servidor de origem.

Para um trabalho, os retornos de chamada FileTransferred são serializados. O BITS não enviará um retorno de chamada para o próximo arquivo no trabalho até que o retorno de chamada atual retorne com êxito.

Os retornos de chamada FileTransferred são enviados antes dos retornos de chamada JobTransferred e JobError.

O retorno de chamada FileTransferred é para trabalhos de download ou a parte de resposta de um trabalho de upload-reply.

Requisitos

Confira também

IBackgroundCopyCallback

IBackgroundCopyCallback2