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 einem Header

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 die Antwort von der Serveranwendung empfangen wurde. Damit BITS die Uploaddatei an den Speicherort kopiert, der durch den Remotedateinamen im Auftrag angegeben wird, fügen Sie den BITS-Copy-File-To-Destination-Header in Ihre Antwort ein. Wenn Sie den Header 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. In der folgenden Tabelle sind die Anforderungsheader aufgeführt.

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.

Die folgende Tabelle zeigt die Antwortheader.

Antwortheader	BESCHREIBUNG
BITS-Static-Response-URL	Optional. Enthält die absolute URL (keine relative URL angeben) zu einer statischen Datendatei, die als Antwort verwendet werden soll. Auf die statische Datendatei muss der BITS-Client zugreifen können. Wenn Sie diesen Header verwenden, erstellen Sie nicht die Antwortdatei, die im Anforderungsheader BITS-Response-DataFile-Name angegeben ist. Beachten Sie, dass BITS diese Datei nicht für Sie löscht.
BITS-Copy-File-To-Destination	Optional. 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 kopiert, der durch den Remotedateinamen im Auftrag angegeben ist, senden Sie diesen Antwortheader. Sie können einen beliebigen Wert angeben. BITS verwendet den Wert nicht. Beachten Sie, dass die Ordner im Remotedateipfad vorhanden sein müssen.

Die folgende Anforderung zeigt, dass BITS 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

Im Folgenden wird die Antwort der Serveranwendung auf BITS dargestellt. 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. Durch das Senden der Uploaddatei im Textkörper der Anforderung können vorhandene Skripts und Anwendungen mit minimalen Änderungen arbeiten. Die Uploaddatei und die Antwortdatei werden 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.

Die folgende Tabelle zeigt die Antwortheader.

Antwortheader	BESCHREIBUNG
BITS-Static-Response-URL	Optional. Enthält die absolute URL (keine relative URL angeben) zu einer statischen Datendatei, die als Antwort verwendet werden soll. Auf die statische Datendatei muss der BITS-Client zugreifen können. Wenn Sie diesen Header verwenden, schließen Sie die Antwort nicht in den Stream ein. Beachten Sie, dass BITS diese Datei nicht für Sie löscht.
BITS-Copy-File-To-Destination	Optional. 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 im Namen der Remotedatei angegeben ist, senden Sie diesen Antwortheader. Sie können einen beliebigen Wert angeben. BITS verwendet den Wert nicht. Beachten Sie, dass die Ordner im Remotedateipfad vorhanden sein müssen.

Die folgende Anforderung zeigt, dass BITS 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, dass die Serveranwendung die Antwortdaten im Text der Antwort an BITS übergibt.

HTTP/1.1 200 - OK
Content-Length: 100

100 bytes of reply data goes here

Behandeln von Serveranwendungsfehlern

Weitere Informationen finden Sie unter Behandeln von Serveranwendungsfehlern.