Ack für Create-Session
Verwenden Sie das Paket Ack for Create-Session , um die Create-Session-Anforderung des Clients zu bestätigen.
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
-
Reason-Code
-
Ersetzen Sie reason-code durch den HTTP-Grundcode. Die folgende Tabelle zeigt die typischen Grundcodes für eine Antwort auf eine Create-Session-Anforderung . Eine Liste der HTTP-Grundcodes finden Sie unter RFC 2616.
Ursachencode BESCHREIBUNG 200 OK. Die Anforderung wurde erfolgreich gesendet. 201 Erstellt. Die Sitzung wurde erstellt. 403 Unzulässig. Der Benutzer darf keine Dateien in die angegebene URL hochladen. 404 Nicht gefunden. Die angegebene URL ist nicht vorhanden. 409 Konflikt. Die Datei ist auf dem Server vorhanden und kann nicht überschrieben werden. -
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-Protokoll
-
Zeichenfolgen-GUID, die das Protokoll identifiziert, das der Server für diese Sitzung verwenden möchte. Ersetzen Sie {guid} durch den Protokollbezeichner aus der Liste der Protokolle, die der Client in die Create-Session-Anforderung enthält. der BITS-Supported-Protocol-Header enthält die Liste. Fügen Sie diesen Header nur hinzu, wenn der Grundcode 200 oder 201 ist.
-
BITS-Session-ID
-
Zeichenfolgen-GUID, die diese Sitzung für den Client identifiziert. Ersetzen Sie {guid} durch den Sitzungsbezeichner, den der Client in allen nachfolgenden Anforderungspaketen sendet.
BITS verwendet eine GUID, um die Sitzung zu identifizieren, aber Sie können eine beliebige HTTP-rechtliche Zeichenfolge bis zu 100 Zeichen verwenden.
-
BITS-Host-ID
-
Optional. Schließen Sie diesen Header nur ein, wenn die BITS IIS-Erweiterungseigenschaft BITSHostId festgelegt ist. Ersetzen Sie PublicHostName durch den Servernamen oder die IP-Adresse aus der BITSHostId-Eigenschaft.
Der Client muss den Serverteil der Remote-URL für alle nachfolgenden Pakete ersetzen. Wenn der Client diesen Hostnamen für nachfolgende Pakete nicht angibt, ist es möglich, dass der Auftrag auf einem anderen Server in der Farm erneut beginnt, sodass eine partielle Uploaddatei auf dem vorherigen Server bleibt.
-
BITS-Host-Id-Fallback-Timeout
-
Optional. Fügen Sie diesen Header nur hinzu, wenn der BITS-Host-Id-Header angegeben ist. Ersetzen Sie Timeout durch den Timeoutwert der BITSHostIdFallbackTimeout-Eigenschaft. Die BITSHostIdFallbackTimeout-Eigenschaft ist eine der BITS IIS-Erweiterungseigenschaften.
Der Client verwendet den Timeoutzeitraum, um zu bestimmen, wie lange er versucht, eine Verbindung mit dem im BITS-Host-Id-Header angegebenen Servernamen herzustellen, bevor er auf den hostnamen zurückgesetzt wird, der im Remotedateinamen des Auftrags angegeben ist. Der Timer beginnt, wenn BITS keine Verbindung mit dem BITS-Host-ID-Server herstellen kann. Der Timer wird zurückgesetzt, wenn eine Verbindung mit dem Server wiederhergestellt wird. Wenn kein Timeoutzeitraum angegeben wird, wird der Client nie auf den hostnamen zurückgesetzt, der im Remotedateinamen angegeben ist.
-
Accept-Encoding
-
Gibt das Codierungsschema an, das für die an den Server gesendeten Fragmente verwendet werden soll. Das Fragmentpaket enthält das codierte Fragment im Textkörper des Pakets. Für den BITS-Server ist die Identitätscodierung (Klartext) erforderlich. Fügen Sie diesen Header nur ein, wenn der Reason-Code 200 oder 201 ist.
-
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. Fügen 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.