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 |