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作业。
如果传递的方法名称与传输类型的默认 HTTP 方法匹配,则 SetHttpMethod 不执行任何操作。 例如,如果将下载作业方法设置为“GET” (默认) ,则不会更改作业优先级。 必须在首次调用启动作业的 IBackgroundCopyJob::Resume 之前设置 HTTP 方法。

要求

要求
最低受支持的客户端 Windows 10 版本 1809 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 bits10_2.h (包括 Bits.h)
Library Bits.lib

另请参阅

IBackgroundCopyJobHttpOptions2