Metode IBackgroundCopyJobHttpOptions::GetCustomHeaders (bits2_5.h)

Mengambil header kustom yang diatur oleh panggilan sebelumnya ke IBackgroundCopyJobHttpOptions::SetCustomHeaders (yaitu, header yang akan dikirim BITS ke jarak jauh, bukan header yang diterima BITS dari jarak jauh).

Sintaks

HRESULT GetCustomHeaders(
  [out] LPWSTR *pRequestHeaders
);

Parameter

[out] pRequestHeaders

String yang dihentikan null yang berisi header kustom. Setiap header dihentikan oleh karakter pengembalian pengangkutan dan umpan baris (CR/LF). Untuk membebaskan string setelah selesai, panggil fungsi CoTaskMemFree .

Nilai kembali

Tabel berikut ini mencantumkan beberapa nilai yang mungkin dikembalikan.

Menampilkan kode	Deskripsi
S_OK	Berhasil mengambil header.
S_FALSE	Pekerjaan tidak menentukan header kustom.
E_ACCESSDENIED	Anda tidak memiliki izin untuk mengambil header kustom, atau [IBackgroundCopyJobHttpOptions3::MakeCustomHeadersWriteOnly](/windows/desktop/api/bits10_3/nf-bits10_3-ibackgroundcopyjobhttpoptions3-makecustomheaderswriteonly) telah dipanggil pada pekerjaan tersebut.
RPC_X_NULL_REF_POINTER	Parameter pRequestHeaders adalah NULL.

Keterangan

Hanya pemilik pekerjaan yang dapat mengambil header kustom. Untuk menentukan header, panggil metode IBackgroundCopyJobHttpOptions::SetCustomHeaders .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	bits2_5.h (termasuk Bits.h)
Pustaka	Bits.lib

Lihat juga

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetCustomHeaders