BG_JOB_STATE 枚举

  • 项目

BG_JOB_STATE枚举为作业的不同状态定义常量值。

语法

typedef enum  { 
  BG_JOB_STATE_QUEUED,
  BG_JOB_STATE_CONNECTING,
  BG_JOB_STATE_TRANSFERRING,
  BG_JOB_STATE_SUSPENDED,
  BG_JOB_STATE_ERROR,
  BG_JOB_STATE_TRANSIENT_ERROR,
  BG_JOB_STATE_TRANSFERRED,
  BG_JOB_STATE_ACKNOWLEDGED,
  BG_JOB_STATE_CANCELLED
} BG_JOB_STATE;

常量

BG_JOB_STATE_QUEUED

指定作业在队列中并等待运行。 如果用户在传输作业时注销，作业将转换为排队状态。

BG_JOB_STATE_CONNECTING

不支持。

BG_JOB_STATE_TRANSFERRING

指定传递优化正在传输作业的数据。

BG_JOB_STATE_SUSPENDED

指定作业暂停 (暂停) 。 若要暂停作业，请调用 IBackgroundCopyJob：：Suspend 方法。 在调用 IBackgroundCopyJob：：Resume、IBackgroundCopyJob：：Complete 或 IBackgroundCopyJob：：Cancel 方法之前，作业将保持挂起状态。

BG_JOB_STATE_ERROR

指定服务无法将文件传输) (发生不可恢复的错误。 如果可以更正错误（例如拒绝访问错误），请在修复错误后调用 IBackgroundCopyJob：：Resume 方法。 但是，如果错误无法更正，请调用 IBackgroundCopyJob：：Cancel 方法来取消作业，或调用 IBackgroundCopyJob：：Complete 方法以接受成功传输的下载作业部分。

BG_JOB_STATE_TRANSIENT_ERROR

指定发生可恢复的错误。 传递优化将根据内部重试配置，重试处于暂时性错误状态的作业。 如果作业无法取得进展 ( 请参阅 IBackgroundCopyJob：：SetNoProgressTimeout) ，作业的状态将更改为BG_JOB_STATE_ERROR。

BG_JOB_STATE_TRANSFERRED

指定已成功处理作业。 必须调用 IBackgroundCopyJob：：Complete 方法来确认作业完成并使文件可供客户端使用。

BG_JOB_STATE_ACKNOWLEDGED

指定调用 IBackgroundCopyJob：：Complete 方法来确认作业已成功完成。

BG_JOB_STATE_CANCELLED

指定调用 IBackgroundCopyJob：：Cancel 方法来取消作业， (从传输队列中删除作业) 。

要求

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

另请参阅

IBackgroundCopyJob：：GetState