Método IBackgroundCopyCallback::JobError

Optimización de distribución llama a la implementación del método JobError cuando el estado del trabajo cambia a BG_JOB_STATE_ERROR.

Sintaxis

HRESULT JobError(
  [in] IBackgroundCopyJob   *pJob,
  [in] IBackgroundCopyError *pError
);

Parámetros

pJob [in]

Contiene información relacionada con el trabajo, como el número de bytes y archivos transferidos antes de que se produjera el error. También contiene los métodos para reanudar y cancelar el trabajo. No liberar pJob; Optimización de distribución libera la interfaz cuando el método JobError devuelve.

pError [in]

Contiene información de error, como el archivo que se está procesando en el momento en que se produjo el error irrecuperable y una descripción del error. No liberar pError; Optimización de distribución libera la interfaz cuando el método JobError devuelve.

Valor devuelto

Este método debe devolver S_OK; De lo contrario, optimización de distribución continúa llamando a este método hasta que se devuelve S_OK . Por motivos de rendimiento, debe limitar el número de veces que se devuelve un valor distinto de S_OK a varias veces. Como alternativa a devolver un código de error, considere la posibilidad de devolver siempre S_OK y controlar el error internamente. El intervalo en el que se llama a este método es arbitrario.

Comentarios

Después de determinar la causa del error, realice una de las siguientes opciones:

• Para cancelar el trabajo, llame al método IBackgroundCopyJob::Cancel .
• Para aceptar la parte del trabajo que se transfirió correctamente antes de que se produjera el error, llame al método IBackgroundCopyJob::Complete . Esta opción no se aplica a la carga de trabajos; no se puede completar una parte de un trabajo de carga.
• Para finalizar el procesamiento del trabajo, corrija el problema y, a continuación, llame al método IBackgroundCopyJob::Resume .

Los errores transitorios no generan llamadas al método JobError .

Optimización de distribución devuelve BG_ERROR_CONTEXT_REMOTE_FILE si el trabajo alcanza un error HTTP 403, BG_ERROR_CONTEXT_NONE de lo contrario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1709 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server, versión 1709 [solo aplicaciones de escritorio]
Encabezado	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Biblioteca	Dosvc.lib
Archivo DLL	Dosvc.dll
IID	IID_IBackgroundCopyCallback se define como 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22

Consulte también

IBackgroundCopyCallback

IBackgroundCopyError

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::Resume