Freigeben über


Ack für Cancel-Session

Verwenden Sie das Paket Ack for Cancel-Session , um die Cancel-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-Grundcode. Legen Sie z. B. den Grundcode 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 für den Client identifiziert. Ersetzen Sie {guid} durch den Sitzungsbezeichner, den der Client im Anforderungspaket Cancel-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 die Länge durch die Anzahl der Bytes, die im Textkörper der Antwort enthalten sind. Erforderlich, auch wenn der Text der Antwort keinen Inhalt enthält.

BITS-Error-Code

Ersetzen Sie fehlercode durch eine hexadezimale Zahl, 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 hexadezimale Zahl, 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. Fügen Sie diesen Header nur ein, wenn der Grundcode nicht 200 oder 201 ist.

Bemerkungen

Der BITS-Client übergibt das Paket Cancel-Session erneut, wenn sich der Grundcode im Bereich von 500 bis 599 befindet, es sei denn, der BITS-Error-Code-Header ist mit dem Wert BG_E_SESSION_NOT_FOUND vorhanden. Der Client versucht nicht nach den Grundcodes 100 bis 499.

Siehe auch

Ack für Close-Session

Cancel-Session