Compartir a través de

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

Elimina el trabajo de la cola de transferencia y quita los archivos temporales relacionados del cliente (descargas) y el servidor (cargas).

Syntax

HRESULT Cancel();

Valor devuelto

Este método devuelve los siguientes valores HRESULT , así como otros.

Código de retorno Description
S_OK
 El trabajo se canceló correctamente.
BG_S_UNABLE_TO_DELETE_FILES
 El trabajo se canceló correctamente; sin embargo, el servicio no pudo eliminar los archivos temporales asociados al trabajo.
BG_E_INVALID_STATE
 No se puede cancelar un trabajo cuyo estado es BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED.

Observaciones

Puede cancelar un trabajo en cualquier momento; sin embargo, el trabajo no se puede recuperar después de cancelarlo.

En el caso de los trabajos de carga, si el servidor no está disponible, puede haber un retraso antes de que BITS elimine el trabajo de la cola. BITS envía periódicamente una solicitud de cancelación al servidor BITS durante hasta 24 horas. Si el servidor no responde dentro del período de 24 horas, BITS quita el trabajo de la cola. Si el período de tiempo de espera sin progreso es inferior a 24 horas, BITS usa el período de tiempo de espera sin progreso para limitar los reintentos.

El método Cancel cancela una carga si la carga no está completa. Si la carga se completa y el trabajo es de tipo BG_JOB_TYPE_UPLOAD_REPLY, el método cancela la respuesta.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows XP
Servidor mínimo admitido Windows Server 2003
de la plataforma de destino de Windows
Header bits.h
Library Bits.lib
DLL de QmgrPrxy.dll

Consulte también

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend

  • Last updated on