IBackgroundCopyJobHttpOptions2::SetHttpMethod 方法 (bits10_2.h)
替代用于 BITS 传输的默认 HTTP 方法。
语法
HRESULT SetHttpMethod(
[in] LPCWSTR method
);
参数
[in] method
类型: LPCWSTR
指向包含 HTTP 方法名称的以 null 结尾的常量字符串的指针。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
BITS 允许开发人员选择默认方法以外的 HTTP 方法。 这增加了 BITS 与不符合 HTTP 服务器正常 BITS 要求的服务器交互的能力。 从默认方法中选择其他 HTTP 方法时,请记住以下几点。
- BITS 自动将作业优先级更改为 BG_JOB_PRIORITY_FOREGROUND,并阻止更改该优先级。
- 通常可恢复 (的错误(例如连接丢失) )会将作业转换为“错误”状态。 开发人员可以通过调用 IBackgroundCopyJob::Resume 来重启作业,作业将从头开始重启。 有关 BITS 作业状态的详细信息, 请参阅 BITS 作业的生命周期。
- BITS 不允许使用 SetHttpMethod DYNAMIC_CONTENT或ON_DEMAND_MODE作业。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 版本 1809 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2016 [仅限桌面应用] |
目标平台 | Windows |
标头 | bits10_2.h (包括 Bits.h) |
Library | Bits.lib |