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 方法,SetHttpMethod就不會執行任何動作。 例如,如果您將下載作業方法設定為 「GET」 (預設) ,則不會變更作業優先順序。 HTTP 方法必須在第一次呼叫啟動作業的 IBackgroundCopyJob::Resume 之前設定。

規格需求

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

另請參閱

IBackgroundCopyJobHttpOptions2