Ack untuk Create-Session

Gunakan paket Ack for Create-Session untuk mengakui permintaan Create-Session klien.

reason-code reason-description
BITS-Packet-Type: Ack
BITS-Protocol: {guid}
BITS-Session-Id: {guid}
BITS-Host-Id: PublicHostName
BITS-Host-Id-Fallback-Timeout: Timeout
Accept-Encoding: Identity
Content-Length: length
BITS-Error-Code: error-code
BITS-Error-Context: error-context

Header

kode alasan

Ganti kode alasan dengan kode alasan HTTP. Tabel berikut ini memperlihatkan kode alasan umum untuk respons terhadap permintaan Buat Sesi . Untuk daftar kode alasan HTTP, lihat RFC 2616.

Kode alasan	Deskripsi
200	OK. Permintaan berhasil.
201	Dibuat. Sesi dibuat.
403	Terlarang. Pengguna tidak diizinkan untuk mengunggah file ke URL yang ditentukan.
404	Tidak Ditemukan. URL yang ditentukan tidak ada.
409	Konflik. File ada pada server dan tidak dapat ditimpa.

deskripsi alasan

Ganti deskripsi alasan dengan deskripsi HTTP yang terkait dengan kode alasan. Misalnya, atur deskripsi alasan ke OK jika kode alasan adalah 200.

BITS-Packet-Type

Mengidentifikasi paket respons ini sebagai paket Ack.

BITS-Protocol

STRING GUID yang mengidentifikasi protokol yang ingin digunakan server untuk sesi ini. Ganti {guid} dengan pengidentifikasi protokol dari daftar protokol yang disertakan klien dalam permintaan Buat Sesi ; header BITS-Supported-Protocol berisi daftar. Sertakan header ini hanya jika kode alasan adalah 200 atau 201.

BITS-Session-Id

STRING GUID yang mengidentifikasi sesi ini ke klien. Ganti {guid} dengan pengidentifikasi sesi yang dikirim klien di semua paket permintaan berikutnya.

BITS menggunakan GUID untuk mengidentifikasi sesi, tetapi Anda dapat menggunakan string http-legal hingga 100 karakter.

BITS-Host-Id

Pilihan. Sertakan header ini hanya jika properti ekstensi BITS IIS, BITSHostId, diatur. Ganti PublicHostName dengan nama server atau alamat IP dari properti BITSHostId.

Klien harus mengganti bagian server dari URL jarak jauh pada semua paket berikutnya. Jika klien tidak menentukan nama host ini pada paket berikutnya, ada kemungkinan bahwa pekerjaan akan dimulai lagi di server lain di farm, meninggalkan file unggahan parsial di server sebelumnya.

BITS-Host-Id-Fallback-Timeout

Pilihan. Sertakan header ini hanya jika header BITS-Host-Id ditentukan. Ganti Timeout dengan nilai waktu habis dari properti BITSHostIdFallbackTimeout. Properti BITSHostIdFallbackTimeout adalah salah satu properti ekstensi BITS IIS.

Klien menggunakan periode waktu habis untuk menentukan berapa lama ia mencoba menyambungkan kembali ke nama server yang ditentukan di header BITS-Host-Id sebelum kembali ke nama host yang ditentukan dalam nama file jarak jauh pekerjaan. Timer dimulai ketika BITS tidak dapat tersambung ke server BITS-Host-Id. Timer direset ketika koneksi ke server dipulihkan. Jika periode waktu habis tidak ditentukan, klien tidak pernah kembali ke nama host yang ditentukan dalam nama file jarak jauh.

Terima-Pengodean

Mengidentifikasi skema pengodean yang akan digunakan pada fragmen yang dikirim ke server. Paket Fragmen berisi fragmen yang dikodekan dalam isi paket. Server BITS memerlukan pengodean Identitas (teks biasa). Sertakan header ini hanya jika Kode alasan adalah 200 atau 201.

Panjang Konten

Ganti panjang dengan jumlah byte yang disertakan dalam isi respons. Diperlukan bahkan jika isi respons tidak menyertakan konten.

BITS-Error-Code

Ganti kode kesalahan dengan angka heksadesimal yang mewakili nilai HRESULT yang terkait dengan kesalahan sisi server. Sertakan header ini hanya jika kode alasan bukan 200 atau 201.

BITS-Error-Context

Ganti konteks kesalahan dengan angka heksadesimal yang mewakili konteks di mana kesalahan terjadi. Tentukan angka heksadesimal untuk BG_ERROR_CONTEXT_REMOTE_FILE (0x5) jika server menghasilkan kesalahan. Jika tidak, tentukan nomor heksadesimal untuk BG_ERROR_CONTEXT_REMOTE_APPLICATION (0x7) jika kesalahan dihasilkan oleh aplikasi tempat file unggahan diteruskan. Sertakan header ini hanya jika kode alasannya bukan 200 atau 201.

Lihat juga

Buat-Sesi