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

  • Artigo

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

Sintaxe

HRESULT Cancel();

Retornar valor

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

Código de retorno Descrição
S_OK
 O trabalho foi cancelado com êxito.
BG_S_UNABLE_TO_DELETE_FILES
 O trabalho foi cancelado com êxito; no entanto, o serviço não pôde excluir os arquivos temporários associados ao trabalho.
BG_E_INVALID_STATE
 Não é possível cancelar um trabalho cujo estado é BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.

Comentários

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 inferior a 24 horas, o BITS usará o período de tempo limite sem progresso para limitar as repetições.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho bits.h
Biblioteca Bits.lib
DLL QmgrPrxy.dll

Confira também

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend