IBackgroundCopyCallback：：JobModification 方法 (bits.h)

修改作业后，BITS 会调用 JobModification 方法的实现。当传输字节、文件已添加到作业、修改属性或作业状态更改时，服务将生成此事件。

语法

HRESULT JobModification(
  [in] IBackgroundCopyJob *pJob,
  [in] DWORD              dwReserved
);

[in] pJob

包含用于访问作业的属性、进度和状态信息的方法。不释放 pJob; 当 JobModification 方法返回时，BITS 释放接口。

[in] dwReserved

保留供将来使用。

此方法应返回 S_OK。

在最大资源负载条件下，实现可能不会收到所有修改事件。

BITS 生成大量修改事件;请考虑创建计时器并轮询状态和进度信息，或限制使用此回调。如果使用此回调，请保持实现简短。

当作业的状态更改为BG_JOB_STATE_ERROR或BG_JOB_STATE_TRANSFERRED时，BITS 不会生成修改事件。

注意 BITS 支持每个用户最多同时发出四个通知。如果一个或多个应用程序阻止用户返回所有四个通知，则在一个或多个阻止通知返回之前，以同一用户身份运行的应用程序将不会收到通知。

请参阅 IBackgroundCopyCallback 接口的示例代码。