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();
Retornar valor
Esse método retorna os seguintes valores HRESULT , bem como outros.
| Código de retorno | Descrição |
|---|---|
|
O trabalho foi cancelado com êxito. |
|
O trabalho foi cancelado com êxito; no entanto, o serviço não pôde excluir os arquivos temporários associados ao trabalho. |
|
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 |