IBackgroundCopyCallback::JobError 方法

当作业的状态更改为BG_JOB_STATE_ERROR时,传递优化会调用 JobError 方法的实现。

语法

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

参数

pJob [in]

包含与作业相关的信息,例如错误发生前传输的字节数和文件数。 它还包含恢复和取消作业的方法。 请勿发布 pJob;传递优化在 JobError 方法返回时释放接口。

pError [in]

包含错误信息,例如在发生致命错误时正在处理的文件以及错误的说明。 请勿释放 pError;传递优化在 JobError 方法返回时释放接口。

返回值

此方法应返回 S_OK;否则,传递优化将继续调用此方法,直到返回 S_OK 。 出于性能原因,应将返回的值( S_OK )的次数限制为几次。 作为返回错误代码的替代方法,请考虑始终返回 S_OK 并在内部处理错误。 调用此方法的间隔是任意的。

注解

确定错误原因后,执行以下选项之一:

暂时性错误不会生成对 JobError 方法的调用。

如果作业遇到 HTTP 403 错误,则传递优化返回BG_ERROR_CONTEXT_REMOTE_FILE否则BG_ERROR_CONTEXT_NONE。

要求

要求
最低受支持的客户端
Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器
Windows服务器版本 1709 [仅限桌面应用]
标头
Deliveryoptimization.h
IDL
DeliveryOptimization.idl

Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyCallback定义为 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22

另请参阅

IBackgroundCopyCallback

IBackgroundCopyError

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::Resume