BITS 返回值

Bitsmsg.h 文件包含以下返回值常量。 常量表示 BITS 生成的返回值和 BITS 捕获的 HTTP 返回值。 可以接收的所有其他返回值都是 COM、RPC 或已转换的 Windows 返回值（BITS 使用 HRESULT_FROM_WIN32 宏将 Windows 返回值转换为 HRESULT 值）。

请注意，Bitsmsg.h 文件包含下面未列出的其他返回值。

BG_S_PARTIAL_COMPLETE (0x00200017)

在调用 IBackgroundCopyJob::Complete 方法之前，成功传输了作业文件的子集。 那些不完整的将被删除。

BG_S_UNABLE_TO_DELETE_FILES (0x0020001A)

无法删除与作业关联的所有临时文件。

BG_S_OVERRIDDEN_BY_POLICY (0x00200055)

配置首选项已成功保存，但不会使用该首选项，因为已配置的组策略设置将覆盖该首选项。

BG_E_NOT_FOUND (0x80200001)

找不到请求的作业。

BG_E_INVALID_STATE (0x80200002)

在当前作业状态下不允许请求的操作。

BG_E_EMPTY (0x80200003)

在恢复作业之前，作业必须包含一个或多个文件。

BG_E_FILE_NOT_AVAILABLE (0x80200004)

文件信息不可用，因为错误与本地或远程文件无关。

BG_E_PROTOCOL_NOT_AVAILABLE (0x80200005)

协议信息不可用，因为错误与指定的传输协议不关联。

BG_E_DESTINATION_LOCKED (0x8020000D)

以本地文件名指定的目标文件系统卷被锁定。

BG_E_VOLUME_CHANGED (0x8020000E)

在本地文件名中指定的目标卷已更改。 例如，原来的软盘被替换成不同的软盘。

BG_E_ERROR_INFORMATION_UNAVAILABLE (0x8020000F)

只有当作业的状态为 BG_JOB_STATE_ERROR 时，才会显示错误信息。 BITS 开始传输作业的数据或客户端退出后，错误信息不可用。

BG_E_NETWORK_DISCONNECTED (0x80200010)

网络适配器未激活或已断开连接。 所有作业都处于 BG_JOB_STATE_TRANSIENT_ERROR 状态。

BG_E_MISSING_FILE_SIZE (0x80200011)

服务器未返回文件大小。 BITS 仅传输静态内容，并要求 HTTP 服务器返回 Content-Length 标头。 如果 URL 指向动态内容，传输请求将失败。

BG_E_INSUFFICIENT_HTTP_SUPPORT (0x80200012)

服务器不支持 HTTP/1.1 协议。

BG_E_INSUFFICIENT_RANGE_SUPPORT (0x80200013)

服务器不支持 Content-Range 标头。 通常，当尝试下载动态内容时会收到此错误。 如果中间代理正在删除 Content-Range 或 Content-Length 标头，也可能会收到此错误。

BG_E_REMOTE_NOT_SUPPORTED (0x80200014)

不支持远程使用 BITS。 有关详细信息，请参阅用户和网络连接。

BG_E_NEW_OWNER_DIFF_MAPPING (0x80200015)

当前所有者与前一所有者的本地文件的网络驱动器映射不同。

BG_E_NEW_OWNER_NO_FILE_ACCESS (0x80200016)

新所有者对临时作业文件的权限不足。

BG_E_PROXY_LIST_TOO_LARGE (0x80200018)

HTTP 代理列表太长。 列表不得超过 32 KB。

BG_E_PROXY_BYPASS_LIST_TOO_LARGE (0x80200019)

HTTP 代理旁路列表太长。 列表不得超过 32 KB。

BG_E_TOO_MANY_FILES (0x8020001C)

不能将多个文件添加到上传作业。

BG_E_LOCAL_FILE_CHANGED (0x8020001D)

传输过程开始后，本地文件的内容已更改。 在上传或上传答复作业的传输过程开始后，本地文件的内容不能更改。

BG_E_TOO_LARGE (0x80200020)

上传文件的大小超过了服务器上指定的最大允许上传大小。

BG_E_STRING_TOO_LONG (0x80200021)

指定的字符串太长。

BG_E_CLIENT_SERVER_PROTOCOL_MISMATCH (0x80200022)

客户端和服务器无法协商用于上传作业的协议。

BG_E_SERVER_EXECUTE_ENABLED (0x80200023)

在与作业关联的 IIS 虚拟目录上启用了脚本或执行权限。 若要将文件上传到虚拟目录，请禁用对虚拟目录的脚本和执行权限。

BG_E_USERNAME_TOO_LARGE (0x80200025)

用户名不能超过 300 个字符。

BG_E_PASSWORD_TOO_LARGE (0x80200026)

密码不能超过 65535 个字符。

BG_E_INVALID_AUTH_TARGET (0x80200027)

指定的身份验证目标无效。

BG_E_INVALID_AUTH_SCHEME (0x80200028)

指定的身份验证方案无效。

BG_E_INVALID_RANGE (0x8020002B)

指定的字节范围无效。 字节范围必须存在于指定的远程文件中。

BG_E_OVERLAPPING_RANGES (0x8020002C)

字节范围列表包含不受支持的重叠或重复范围。

BG_E_BLOCKED_BY_POLICY (0x8020003E)

组策略设置可阻止后台作业此时运行。 有关详细信息，请参阅 MaxInternetBandwidth 策略。

BG_E_INVALID_PROXY_INFO (0x8020003F)

运行时错误，指示使用 IBackgroundCopyJob::SetProxySettings 方法指定的代理列表或代理旁路列表无效。

BG_E_INVALID_CREDENTIALS (0x80200040)

提供的安全凭据的格式无效。

BG_E_RECORD_DELETED (0x80200042)

缓存的记录已被删除。 更新它的尝试已被放弃。

BG_E_UPNP_ERROR (0x80200045)

发生了通用即插即用 (UPnP) 错误。 请检查 Internet 网关设备。

BG_E_PEERCACHING_DISABLED (0x80200047)

已禁用对等缓存。

BG_E_BUSYCACHERECORD (0x80200048)

缓存记录正在使用中，不能更改或删除。 几秒后重试。

BG_E_TOO_MANY_JOBS_PER_USER (0x80200049)

用户的作业计数已超过 MaxJobsPerUser 组策略设置设置的每个用户作业限制。

BG_E_TOO_MANY_JOBS_PER_MACHINE (0x80200050)

计算机的作业计数已超过 MaxJobsPerMachine 组策略设置所设置的每台计算机的作业限制。

BG_E_TOO_MANY_FILES_IN_JOB (0x80200051)

作业的文件计数已超过 MaxFilesPerJob 组策略设置所设置的每个作业文件的限制。

BG_E_TOO_MANY_RANGES_IN_FILE (0x80200052)

文件的范围计数已超过 MaxRangesPerFile 组策略设置所设置的每个文件的范围限制。

BG_E_VALIDATION_FAILED (0x80200053)

应用程序从网站请求数据，但响应无效。 有关详细信息，请使用事件查看器查看 Application Logs\Microsoft\Windows\Bits-client\Operational 日志。

BG_E_MAXDOWNLOAD_TIMEOUT (0x80200054)

BITS 已超时下载作业。 下载未在作业上设置的最大下载时间或 MaxDownloadTime 组策略设置内完成。

BG_E_HTTP_ERROR_400 (0x80190190)

服务器无法处理传输请求，因为远程文件名的语法无效。

BG_E_HTTP_ERROR_401 (0x80190191)

用户没有访问远程文件的权限。 请求的资源需要用户身份验证。

BG_E_HTTP_ERROR_404 (0x80190194)

服务器上不存在请求的 URL。

在 IIS 7 中，此错误可以指示

• 该 BITS 上传未在服务器上的虚拟目录 (vdir) 上启用。
• 上传大小超过最大上传限制（有关详细信息，请参阅 BITSMaximumUploadSize IIS 扩展属性）。

BG_E_HTTP_ERROR_407 (0x80190197)

用户没有访问代理的权限。 代理需要用户身份验证。

BG_E_HTTP_ERROR_414 (0x8019019E)

服务器无法处理传输请求。 远程文件名中的统一资源标识符 (URI) 比服务器可以解释的时间长。

BG_E_HTTP_ERROR_501 (0x801901F5)

服务器不支持完成请求所需的功能。 在 IIS 6 中，此错误指示服务器上虚拟目录 (vdir) 上未启用 BITS 上传。

BG_E_HTTP_ERROR_503 (0x801901F7)

服务暂时重载，无法处理请求。 稍后恢复作业。

BG_E_HTTP_ERROR_504 (0x801901F8)

传输请求在等待网关时超时。 稍后恢复作业。

BG_E_HTTP_ERROR_505 (0x801901F9)

服务器不支持远程文件名中指定的 HTTP 协议版本。

Bitsmsg.h 头文件包含 BITS 内部使用的未在上面列出的其他 HTTP 返回值。 有关可接收的这些值和其他 HTTP 返回值的信息，请参阅 https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10 上 Internet 工程任务组的 RFC 2616 规范。