Ack for Create-Session
使用 Ack for Create-Session 封包來確認用戶端的 Create-Session 要求。
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
標題
-
reason-code
-
將 reason-code 取代為 HTTP 原因碼。 下表顯示回應 Create-Session 要求的一般原因代碼。 如需 HTTP 原因代碼的清單，請參閱 RFC 2616。
原因代碼 描述 200 正常。 要求成功。 201 已建立。 會話已建立。 403 禁止。 使用者不允許將檔案上傳至指定的 URL。 404 找不到。 指定的 URL 不存在。 409 衝突。 檔案存在於伺服器上，無法覆寫。 -
reason-description
-
將 reason-description 取代為與原因代碼相關聯的 HTTP 描述。 例如，如果 reason-code 為 200，請將原因描述設定為 [確定]。
-
BITS-Packet-Type
-
將此回應封包識別為 Ack 封包。
-
BITS-Protocol
-
字串 GUID，識別伺服器想要用於此會話的通訊協定。 將 {guid} 取代為用戶端在 建立會話 要求中包含之通訊協定清單中的通訊協定識別碼;BITS-Supported-Protocol 標頭包含清單。 只有在原因碼為 200 或 201 時，才包含此標頭。
-
BITS-Session-Id
-
識別此會話給用戶端的字串 GUID。 將 {guid} 取代為用戶端在所有後續要求封包中傳送的會話識別碼。
BITS 會使用 GUID 來識別會話，但您可以使用最多 100 個字元的任何 HTTP 法務字串。
-
BITS-Host-Id
-
選擇性。 只有在已設定 BITS IIS 擴充屬性BITSHostId 時，才包含此標頭。 將 PublicHostName 取代為 BITSHostId 屬性的伺服器名稱或 IP 位址。
用戶端必須取代所有後續封包上遠端 URL 的伺服器部分。 如果用戶端未在後續封包上指定此主機名稱，則作業可能會再次在伺服器陣列中的另一部伺服器上開始，並在上一部伺服器上保留部分上傳檔案。
-
BITS-Host-Id-Fallback-Timeout
-
選擇性。 只有在指定 BITS-Host-Id 標頭時，才包含此標頭。 將 Timeout 取代為 BITSHostIdFallbackTimeout 屬性中的逾時值。 BITSHostIdFallbackTimeout 屬性是其中一個 BITS IIS 擴充功能屬性。
用戶端會使用逾時期間來判斷它嘗試重新連線到 BITS-Host-Id 標頭中指定的伺服器名稱多久，再還原為作業遠端檔案名中指定的主機名稱。 當 BITS 無法連線到 BITS-Host-Id 伺服器時，計時器就會開始。 還原伺服器連線時，計時器會重設。 如果未指定逾時期間，用戶端永遠不會還原為遠端檔案名中指定的主機名稱。
-
Accept-Encoding
-
識別傳送至伺服器的片段上要使用的編碼配置。 片段封包包含封包主體中的編碼片段。 BITS 伺服器需要純文字編碼 (純文字編碼) 。 只有在 Reason-code 為 200 或 201 時，才包含此標頭。
-
Content-Length
-
以回應主體中包含的位元組數目取代 length。 即使回應主體不包含內容，仍需要 。
-
BITS-Error-Code
-
以十六進位數位取代錯誤碼，代表與伺服器端錯誤相關聯的 HRESULT 值。 只有在原因程式碼不是 200 或 201 時，才包含此標頭。
-
BITS-Error-CoNtext
-
以十六進位數位取代錯誤內容，代表發生錯誤的內容。 如果伺服器產生錯誤，請指定 BG_ERROR_CONTEXT_REMOTE_FILE (0x5) 的十六進位數。 否則，如果上傳檔案傳遞至的應用程式產生錯誤，請指定 BG_ERROR_CONTEXT_REMOTE_APPLICATION (0x7) 的十六進位數。 只有在原因碼不是 200 或 201 時，才包含此標頭。