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 方法中選擇不同的 HTTP 方法時，請記住下列事項。

  • BITS 會自動將作業優先順序變更為 BG_JOB_PRIORITY_FOREGROUND，並防止該優先順序變更。
  • 通常會繼續 (的錯誤，例如連線中斷) 將作業轉換為 ERROR 狀態。 身為開發人員的您，可以藉由呼叫 IBackgroundCopyJob：：Resume 重新啟動作業，並從頭開始重新啟動作業。 如需 BITS 作業狀態的詳細資訊，請參閱 BITS 作業的生命週期 。
  • BITS 不允許使用 SetHttpMethod DYNAMIC_CONTENT或ON_DEMAND_MODE作業。
如果傳遞的方法名稱符合傳輸類型的默認 HTTP 方法，Set HttpMethod 就不會執行任何動作。 例如，如果您將下載作業方法設定為 「GET」 (預設) ，則不會變更作業優先順序。 HTTP 方法必須在第一次呼叫啟動作業的 IBackgroundCopyJob：：Resume 之前設定。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1809 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 bits10_2.h (包含 Bits.h)
程式庫 Bits.lib

另請參閱

IBackgroundCopyJobHttpOptions2