Método IBackgroundCopyJob::Cancel (bits.h)

Exclui o trabalho da fila de transferência e remove arquivos temporários relacionados do cliente (downloads) e do servidor (uploads).

Sintaxe

HRESULT Cancel();

Valor de retorno

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

Observações

Você pode cancelar um trabalho a qualquer momento; no entanto, o trabalho não pode ser recuperado depois de cancelado.

Para trabalhos de upload, se o servidor não estiver disponível, pode haver um atraso antes que o BITS exclua o trabalho da fila. O BITS envia periodicamente uma solicitação de cancelamento para o servidor BITS por até 24 horas. Se o servidor não responder dentro do período de 24 horas, o BITS removerá o trabalho da fila. Se o período de tempo limite sem progresso for menor que 24 horas, o BITS usará o período de tempo limite sem progresso para limitar as novas tentativas.

O método Cancel cancela um upload se o upload não estiver concluído. Se o upload estiver concluído e o trabalho for do tipo BG_JOB_TYPE_UPLOAD_REPLY, o método cancelará a resposta.

Requirements

Consulte também

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend