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 |
|
| IDL |
|
| Biblioteca |
|
| Archivo DLL |
|
| IID |
IID_IBackgroundCopyCallback se define como 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22 |