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).
Sintaxis
HRESULT Cancel();
Valor devuelto
Este método devuelve los siguientes valores HRESULT , así como otros.
| Código devuelto | Descripción |
|---|---|
|
El trabajo se canceló correctamente. |
|
El trabajo se canceló correctamente; sin embargo, el servicio no pudo eliminar los archivos temporales asociados al trabajo. |
|
No se puede cancelar un trabajo cuyo estado es BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED. |
Comentarios
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 un máximo de 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 está completa y el trabajo es de tipo BG_JOB_TYPE_UPLOAD_REPLY, el método cancela la respuesta.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP |
| Servidor mínimo compatible | Windows Server 2003 |
| Plataforma de destino | Windows |
| Encabezado | bits.h |
| Library | Bits.lib |
| Archivo DLL | QmgrPrxy.dll |