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

  • Artículo

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
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.

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

Consulte también

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend