Ack für Close-Session
Verwenden Sie das Paket Ack for Close-Session , um die Close-Session-Anforderung des Clients zu bestätigen. Der Server sendet die Bestätigung, nachdem alle Ressourcen freigegeben wurden, 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-Ursachencode. Legen Sie z. B. den Grundcode bei Erfolg auf 200 fest. Eine Liste der HTTP-Ursachencodes finden Sie unter RFC 2616.
-
Reason-description
-
Ersetzen Sie reason-description durch die HTTP-Beschreibung, die dem Ursachencode zugeordnet ist. Legen Sie z. B. 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 für den Client identifiziert. Ersetzen Sie {guid} durch den Sitzungsbezeichner, den der Client im Anforderungspaket Close-Session gesendet hat. Wenn Sie den Sitzungsbezeichner nicht erkennen, legen Sie den BITS-Error-Code-Header auf BG_E_SESSION_NOT_FOUND fest.
-
Inhaltslänge
-
Ersetzen Sie length durch die Anzahl der Bytes, die im Textkörper der Antwort enthalten sind. Content-Length ist erforderlich, auch wenn der Text der Antwort keinen Inhalt enthält.
-
BITS-Error-Code
-
Ersetzen Sie den Fehlercode durch eine Hexadezimalzahl, die einen HRESULT-Wert darstellt, der einem serverseitigen Fehler zugeordnet ist. Schließen Sie diesen Header nur ein, wenn der Grundcode 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.
Bemerkungen
Der BITS-Client gibt das Close-Session-Paket erneut aus, 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 die Ursachencodes 100 bis 499 nicht wiederholen.
Siehe auch