Bagikan melalui

Metode IBackgroundCopyJobHttpOptions2::SetHttpMethod (bits10_2.h)

  • Artikel

Mengambil alih metode HTTP default yang digunakan untuk transfer BITS.

Sintaks

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

Parameter

[in] method

Jenis: LPCWSTR

Penunjuk ke string karakter lebar yang dihentikan null konstanta yang berisi nama metode HTTP.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

BITS memungkinkan Anda, sebagai pengembang, untuk memilih metode HTTP selain metode default. Ini meningkatkan kemampuan BITS untuk berinteraksi dengan server yang tidak mematuhi persyaratan BITS normal untuk server HTTP. Ingatlah hal-hal berikut ketika Anda memilih metode HTTP yang berbeda dari metode default.

  • BITS secara otomatis mengubah prioritas pekerjaan menjadi BG_JOB_PRIORITY_FOREGROUND, dan mencegah prioritas tersebut diubah.
  • Kesalahan yang biasanya dapat diulang (seperti hilangnya konektivitas) mengalihkan pekerjaan ke status ERROR. Anda, sebagai pengembang, dapat memulai ulang pekerjaan dengan memanggil IBackgroundCopyJob::Resume, dan pekerjaan akan dimulai ulang dari awal. Lihat Siklus Hidup Pekerjaan BITS untuk informasi selengkapnya tentang status pekerjaan BITS.
  • BITS tidak mengizinkan pekerjaan DYNAMIC_CONTENT atau ON_DEMAND_MODE dengan SetHttpMethod.
SetHttpMethod tidak melakukan apa pun jika nama metode yang Anda lewati cocok dengan metode HTTP default untuk jenis transfer. Misalnya, jika Anda mengatur metode pekerjaan unduhan ke "GET" (default), maka prioritas pekerjaan tidak akan diubah. Metode HTTP harus diatur sebelum panggilan pertama ke IBackgroundCopyJob::Resume yang memulai pekerjaan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1809 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2016 [hanya aplikasi desktop]
Target Platform Windows
Header bits10_2.h (termasuk Bits.h)
Pustaka Bits.lib

Lihat juga

IBackgroundCopyJobHttpOptions2