Ack for Close-Session

Verwenden Sie das Ack for Close-Session-Paket, um die Close-Session-Anforderung des Clients zu bestätigen. Der Server sendet die Bestätigung nach der Freigabe aller Ressourcen, die der Uploadsitzung zugeordnet sind.

reason-code reason-description
BITS-Packet-Type: Ack
BITS-Session-Id: {guid}
Content-Length: length
BITS-Error-Code: error-code
BITS-Error-Context: error-context

Header

reason-code

Ersetzen Sie reason-code durch den HTTP-Grundcode. Legen Sie z. B. reason-code bei Erfolg auf 200 fest. Eine Liste der HTTP-Grundcodes finden Sie unter RFC 2616.

reason-description

Ersetzen Sie reason-description durch die HTTP-Beschreibung, die dem Grundcode zugeordnet ist. Legen Sie beispielsweise reason-description auf OK fest, wenn reason-code 200 ist.

BITS-Packet-Type

Identifiziert dieses Antwortpaket als Ack-Paket.

BITS-Session-Id

Zeichenfolgen-GUID, die die Sitzung mit dem Client identifiziert. Ersetzen Sie {guid} durch den Sitzungsbezeichner, den der Client im Close-Session-Anforderungspaket gesendet hat. Wenn Sie den Sitzungsbezeichner nicht erkennen, legen Sie den BITS-Error-Code-Header auf BG _ E SESSION NOT FOUND _ _ _ fest.

Content-Length

Ersetzen Sie length durch die Anzahl der Bytes, die im Text der Antwort enthalten sind. Content-Length ist erforderlich, auch wenn der Text der Antwort keinen Inhalt enthält.

BITS-Fehlercode

Ersetzen Sie error-code durch eine Hexadezimalzahl, die einen HRESULT-Wert darstellt, der einem serverseitigen Fehler zugeordnet ist. Schließen Sie diesen Header nur ein, wenn reason-code nicht 200 oder 201 ist.

BITS-Error-Context

Ersetzen Sie error-context durch eine Hexadezimalzahl, die den Kontext darstellt, in dem der Fehler aufgetreten ist. Geben Sie die Hexadezimalzahl für BG ERROR CONTEXT REMOTE _ _ _ _ FILE (0x5) an, wenn der Server den Fehler generiert hat. Geben Sie andernfalls die Hexadezimalzahl für BG ERROR CONTEXT REMOTE _ _ _ _ APPLICATION (0x7) an, wenn der Fehler von der Anwendung generiert wurde, an die die Uploaddatei übergeben wird. Schließen Sie diesen Header nur ein, wenn der Grundcode nicht 200 oder 201 ist.

Hinweise

Der BITS-Client gibt das Close-Session-Paket erneut zurück, wenn der Grundcode im Bereich von 500 bis 599 liegt, es sei denn, der BITS-Error-Code-Header ist mit dem Wert BG _ E SESSION NOT FOUND _ _ _ vorhanden. Der Client wird den Grundcode 100 bis 499 nicht wiederholen.

Weitere Informationen

Ack für Cancel-Session

Close-Session