Benachrichtigungsprotokoll für Serveranwendungen

BITS verwendet die BITSServerNotificationType-Eigenschaft, um zu bestimmen, wie BITS den Inhalt der Uploaddatei an die Serveranwendung sendet. Wenn die BITSServerNotificationType-Eigenschaft auf 1 festgelegt ist, übergibt BITS den Speicherort der Uploaddatei in einem Header. Wenn die BITSServerNotificationType-Eigenschaft auf 2 festgelegt ist, übergibt BITS den Inhalt der Uploaddatei im Textkörper der Anforderung.

Ausführliche Informationen zur Behandlung von Fehlern aus der Serveranwendung finden Sie unter Behandeln von Serveranwendungsfehlern.

Senden des Speicherorts der Uploaddatei in einer Kopfzeile

BITS übergibt den Speicherort der Upload- und Antwortdateien an die Serveranwendung in den Headern, wenn die BITSServerNotificationType-Eigenschaft auf 1 festgelegt ist. Die Serveranwendung öffnet die Uploaddatei, verarbeitet die Daten und generiert dann die Antwortdatei. Standardmäßig entfernt BITS die Upload- und Antwortdateien vom Server, nachdem sie die Antwort von der Serveranwendung erhalten hat. Damit BITS die Uploaddatei an den Speicherort kopieren soll, der durch den Remotedateinamen im Auftrag angegeben wird, fügen Sie den BITS-Copy-File-To-Destination Header in Ihre Antwort ein. Wenn Sie die Kopfzeile nicht einschließen und die Upload- und Antwortdateien speichern möchten, müssen Sie die Upload- und Antwortdateien an einen neuen Speicherort kopieren, bevor Sie antworten. Die folgende Tabelle zeigt die Anforderungsheader.

Anforderungsheader	Beschreibung
BITS-Original-Request-URL	Enthält den im Auftrag angegebenen Remotenamen.
BITS-Request-DataFile-Name	Enthält den vollständigen Pfad zu den hochgeladenen Daten.
BITS-Response-DataFile-Name	Enthält den vollständigen Pfad, zu dem BITS erwartet, dass die Serveranwendung die Antwort schreibt.

In der folgenden Tabelle sind die Antwortheader aufgeführt.

Antwortheader	Beschreibung
BITS-Static-Response-URL	Wahlfrei. Enthält die absolute URL (keine relative URL angeben) zu einer statischen Datendatei, die als Antwort verwendet werden soll. Auf die statische Datendatei muss vom BITS-Client zugegriffen werden kann. Wenn Sie diesen Header verwenden, erstellen Sie nicht die antwortdatei, die im BITS-Response-DataFile-Name Anforderungsheader angegeben ist. Beachten Sie, dass BITS diese Datei nicht für Sie löscht.
BITS-Copy-File-To-Destination	Wahlfrei. Wenn die BITSServerNotificationType-Eigenschaft standardmäßig auf 1 oder 2 festgelegt ist, kopiert der BITS-Server die Uploaddatei nicht an den Speicherort, der durch den Remotedateinamen im Auftrag angegeben wird. Damit BITS die Datei an den Speicherort kopieren soll, der durch den Remotedateinamen im Auftrag angegeben wird, senden Sie diesen Antwortheader. Sie können einen beliebigen Wert angeben; BITS verwendet nicht den Wert. Beachten Sie, dass die Ordner im Remotedateipfad vorhanden sein müssen.

Die folgende Anforderung zeigt BITS, die den Speicherort der Uploaddatei an die Serveranwendung sendet.

POST https://myserver/myvdir/handle_upload.asp?ACCOUNT=873112 HTTP/1.1
Host: myserver
BITS-Original-Request-URL: https://front-end-server/vdir
BITS-Request-DataFile-Name: c:\physical-path\BITS-Sessions\{5e53c221-f2d6-4bf2-
b994-1dc43ceaca8d}\request
BITS-Response-DataFile-Name: c:\physical-path\BITS-Sessions\{5e53c221-f2d6-4bf2-
b994-1dc43ceaca8d}\response
Content-Length: 0

Die folgende Abbildung zeigt die Antwort der Serveranwendung auf BITS; die Antwort wird in der Datei platziert, die durch den BITS-Response-DataFile-Name Anforderungsheader angegeben wird.

HTTP/1.1 200 - OK
Content-Length: 0

Senden der Uploaddatei im Textkörper der Anforderung

BITS sendet die Uploaddatei im Textkörper der Anforderung, wenn die BITSServerNotificationType--Eigenschaft auf 2 festgelegt ist. Wenn Sie die Uploaddatei im Textkörper der Anforderung senden, können vorhandene Skripts und Anwendungen mit minimalen Änderungen arbeiten. Die Uploaddatei bzw. Antwortdatei wird in der Anforderung bzw. Antwort übergeben. Die folgende Tabelle zeigt den Anforderungsheader.

Anforderungsheader	Beschreibung
BITS-Original-Request-URL	Enthält den im Auftrag angegebenen Remotenamen.

In der folgenden Tabelle sind die Antwortheader aufgeführt.

Antwortheader	Beschreibung
BITS-Static-Response-URL	Wahlfrei. Enthält die absolute URL (keine relative URL angeben) zu einer statischen Datendatei, die als Antwort verwendet werden soll. Auf die statische Datendatei muss vom BITS-Client zugegriffen werden kann. Wenn Sie diesen Header verwenden, schließen Sie die Antwort nicht in den Datenstrom ein. Beachten Sie, dass BITS diese Datei nicht für Sie löscht.
BITS-Copy-File-To-Destination	Wahlfrei. Wenn die BITSServerNotificationType-Eigenschaft auf 1 oder 2 festgelegt ist, kopiert der BITS-Server die Uploaddatei nicht an den Speicherort, der durch den Remotedateinamen im Auftrag angegeben wird. Damit BITS die Datei an den Speicherort kopieren soll, der durch den Remotedateinamen angegeben wird, senden Sie diesen Antwortheader. Sie können einen beliebigen Wert angeben; BITS verwendet nicht den Wert. Beachten Sie, dass die Ordner im Remotedateipfad vorhanden sein müssen.

Die folgende Anforderung zeigt BITS, die die hochgeladene Datei an die Serveranwendung im Textkörper der Anforderung übergibt.

POST https://myserver/myvdir/handle_upload.asp?ACCOUNT=873112 HTTP/1.1
Host: myserver
BITS-Original-Request-URL: https://front-end-server/vdir
Content-Length: 80000

80000 bytes of upload data goes here

Die folgende Antwort zeigt die Serveranwendung, die die Antwortdaten an BITS im Textkörper der Antwort übergibt.

HTTP/1.1 200 - OK
Content-Length: 100

100 bytes of reply data goes here

Behandeln von Serveranwendungsfehlern

Siehe Behandeln von Serveranwendungsfehlern.