BITS_JOB_PROPERTY_ID 枚举 (bits5_0.h)

  • 项目

定义指定 BITS 作业的属性 ID 的常量。

此枚举在 BITS_JOB_PROPERTY_VALUE 联合中用于确定联合中包含的值的类型。

语法

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

常量

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
值：1
用于控制手机网络和/或类似网络上 的传输行为的 ID。 转移正在进行时，可能会更改此属性 - 新的成本标志将立即生效。

此属性使用 BITS_JOB_PROPERTY_VALUE的 DWORD 字段。
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
值： 2
用于通过 CLSID 注册 COM 回调 以接收有关 BITS 作业进度和完成的通知的 ID。 CLSID 必须引用与已注册的进程外 COM 服务器关联的类。 还可以将其设置为 GUID_NULL 以清除以前设置的通知 CLSID。

此属性使用 BITS_JOB_PROPERTY_VALUE 的 CLsID 字段。
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
值： 3
用于将 BITS 作业标记为愿意下载不支持 BITS 下载的常规 HTTP 要求的内容的 ID：HEAD请求、Content-Length 标头和 Content-Range 标头。 下载此类内容是选择加入的，因为没有该支持，BITS 无法暂停和恢复下载作业。 如果启用了此属性的作业因任何原因（例如网络连接暂时中断或系统重启）而中断，BITS 将从头开始重启下载，而不是从中断的位置恢复下载。 BITS 也不能限制动态下载的带宽使用;BITS 不会对未分配 BG_JOB_PRIORITY_FOREGROUND 的任何作业执行不受限制的传输，因此，每次使用设置作业时，通常都应将该优先级设置为允许动态内容。

此属性使用 BITS_JOB_PROPERTY_VALUE的 Enable 字段。 此属性仅支持 BG_JOB_TYPE_DOWNLOAD 作业。 使用 FILE_RANGES 的下载不支持它。 只能在首次对作业调用 Resume 之前设置此属性。
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
值： 4
用于将 BITS 作业标记为不需要强可靠性保证的 ID。 启用此属性将导致 BITS 避免保留有关正常作业进度的信息，而 BITS 通常会定期这样做。 在传输期间发生意外关闭（例如断电）时，这将导致 BITS 丢失进度

然后从头开始重启作业，而不是像往常一样从中断的位置恢复作业。 但是，它还会减少 BITS 在作业生存期内执行的磁盘写入数，从而提高小型作业的性能。

此属性还会导致 BITS 直接下载到目标文件，而不是下载到临时文件，并在传输完成后将临时文件移动到最终目标。 这意味着，如果作业被取消或遇到严重错误情况，BITS 不会清理任何部分下载的内容;如果目标文件已创建，则 BITS 调用方负责清理它。 但是，它也会稍微减少磁盘开销。

仅当涉及大量小型作业 (低于 1MB) 且不需要可靠性的断电或其他意外关闭事件的情况下，才建议使用此属性。 对于少量作业或大型作业，性能节省通常并不显著。

此属性使用 BITS_JOB_PROPERTY_VALUE的 Enable 字段。 此属性仅支持 BG_JOB_TYPE_DOWNLOAD 作业。 只能在将任何文件添加到作业之前设置此属性。
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
值： 5
用于标记 BITS 作业总共允许下载的最大字节数的 ID。 此属性适用于 BITS_JOB_PROPERTY_DYNAMIC_CONTENT，你可能无法提前确定要下载的文件的大小，但希望限制可能的总下载大小。

此属性使用 BITS_JOB_PROPERTY_VALUE的 Enable 字段。 此属性仅支持 BG_JOB_TYPE_DOWNLOAD 作业。 只能在首次对作业调用 Resume 之前设置此属性。
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
值： 7
用于将 BITS 作业标记为愿意在对代理服务器的请求中包含默认凭据的 ID。 启用此属性等效于对 BITS 代表用户发出的请求将 WinHTTP 安全级别 设置为 WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM 。 用户 BITS 从 检索存储的凭据与它代表发出网络请求的凭据相同：BITS 通常将使用作业所有者的凭据，除非你已显式提供网络 帮助程序令牌，在这种情况下，BITS 将使用网络帮助程序令牌的凭据。

此属性使用BITS_JOB_PROPERTY_VALUE的 Target 字段。 但是，仅支持 BG_AUTH_TARGET_PROXY 目标。
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
值： 9
用于控制 BITS JobNotification 和 FileRangesTransferred 通知的计时的 ID。 启用此属性可让用户以不同的速率收到通知。 在传输过程中，可能会更改此属性：但是，新费率可能不会立即应用。 默认值为 500 毫秒。

此属性使用 BITS_JOB_PROPERTY_VALUE的 DWORD 字段。
BITS_JOB_PROPERTY_ON_DEMAND_MODE
值： 10
用于控制作业是否处于按需模式的 ID。 按需作业允许应用请求文件下载的特定范围，而不是从头到尾下载。 默认值为 FALSE;作业不是按需作业。 使用 IBackgroundCopyFile6：：RequestFileRanges 方法请求范围。

此属性使用 BITS_JOB_PROPERTY_VALUE的 Enable 字段。

BITS_JOB_PROPERTY_ON_DEMAND_MODE作业的要求是传输必须是BG_JOB_TYPE_DOWNLOAD作业。 作业不能是 动态 的，服务器必须是 HTTP 或 HTTPS 服务器，并且必须满足服务器对范围支持的要求。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
标头 bits5_0.h

另请参阅