Protokol oznámení pro serverové aplikace

BitS používá vlastnost BITSServerNotificationType k určení způsobu odesílání obsahu souboru nahrání do serverové aplikace. Pokud je vlastnost BITSServerNotificationType nastavena na hodnotu 1, BITS předá umístění souboru nahrání v hlavičce. Pokud je vlastnost BITSServerNotificationType nastavena na hodnotu 2, BITS předá obsah souboru nahrání v textu požadavku.

Podrobnosti o tom, jak BITS zpracovává chyby ze serverové aplikace, najdete v tématu Zpracování chyb aplikace serveru.

Odeslání umístění nahrání souboru v hlavičce

BitS předá umístění souborů pro nahrání a odpovídání serverové aplikaci v hlavičce, pokud je vlastnost BITSServerNotification Type nastavená na hodnotu 1. Serverová aplikace otevře soubor pro nahrání, zpracuje data a pak vygeneruje soubor odpovědi. Služba BITS ve výchozím nastavení odebere soubory nahrávání a odpovědí ze serveru, jakmile obdrží odpověď ze serverové aplikace. Pokud chcete, aby služba BITS zkopírovala soubor pro nahrávání do umístění určeného názvem vzdáleného souboru v úloze, vložte do odpovědi hlavičku BITS-Copy-File-To-Destination. Pokud záhlaví nezahrnete a chcete uložit soubory pro nahrání a odpovědi, musíte soubory pro nahrání a odpovědi zkopírovat do nového umístění, než odpovíte. Následující tabulka obsahuje hlavičky požadavku.

Hlavička požadavku	Popis
Bits -Original-Request-URL	Obsahuje vzdálený název zadaný v úloze.
Požadavek BITS –DataFile-Name	Obsahuje úplnou cestu k nahraných datům.
Bits -Response-DataFile-Name	Obsahuje úplnou cestu, do které služba BITS očekává, že serverová aplikace zapíše odpověď.

Následující tabulka obsahuje hlavičky odpovědi.

Hlavička odpovědi	Popis
Bits Static–Response-URL	Volitelný. Obsahuje absolutní adresu URL (nezadávejte relativní adresu URL) statického datového souboru, který se má použít jako odpověď. Statický datový soubor musí být přístupný klientem SLUŽBY BITS. Pokud použijete tuto hlavičku, nevytvádejte soubor odpovědi zadaný v hlavičce požadavku BITS-Response-DataFile-Name. Všimněte si, že služba BITS tento soubor za vás neodstraní.
BITS-Copy-File-To-Destination	Volitelný. Pokud je vlastnost BITSServerNotificationType nastavena na hodnotu 1 nebo 2, server BITS nezkopíruje soubor pro nahrání do umístění určeného názvem vzdáleného souboru v úloze. Pokud chcete, aby služba BITS soubor zkopírovala do umístění určeného názvem vzdáleného souboru v úloze, odešlete tuto hlavičku odpovědi. Můžete zadat libovolnou hodnotu; Služba BITS tuto hodnotu nepoužívá. Všimněte si, že složky ve vzdálené cestě k souboru musí existovat.

Následující požadavek ukazuje službu BITS, která odesílá umístění souboru pro nahrání do serverové aplikace.

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

Následující příklad ukazuje odpověď serverové aplikace na službu BITS; odpověď se umístí do souboru určeného hlavičkou požadavku BITS-Response-DataFile-Name.

HTTP/1.1 200 - OK
Content-Length: 0

Odeslání souboru pro nahrání v textu požadavku

BitS odešle soubor pro nahrání v těle požadavku, pokud je vlastnost BITSServerNotificationType nastavená na hodnotu 2. Odeslání souboru pro nahrání v textu požadavku umožňuje stávajícím skriptům a aplikacím pracovat s minimálními úpravami. Soubor pro nahrání a soubor odpovědi se předávají v požadavku a odpovědi. Následující tabulka obsahuje hlavičku požadavku.

Hlavička požadavku	Popis
Bits -Original-Request-URL	Obsahuje vzdálený název zadaný v úloze.

Následující tabulka obsahuje hlavičky odpovědi.

Hlavička odpovědi	Popis
Bits Static–Response-URL	Volitelný. Obsahuje absolutní adresu URL (nezadávejte relativní adresu URL) statického datového souboru, který se má použít jako odpověď. Statický datový soubor musí být přístupný klientem SLUŽBY BITS. Pokud použijete tuto hlavičku, nezahrnujte odpověď do datového proudu. Všimněte si, že služba BITS tento soubor za vás neodstraní.
BITS-Copy-File-To-Destination	Volitelný. Pokud je vlastnost BITSServerNotificationType nastavena na hodnotu 1 nebo 2, server BITS nekopíruje soubor pro nahrání do umístění určeného názvem vzdáleného souboru v úloze. Pokud chcete, aby služba BITS soubor zkopírovala do umístění určeného názvem vzdáleného souboru, odešlete tuto hlavičku odpovědi. Můžete zadat libovolnou hodnotu; Služba BITS tuto hodnotu nepoužívá. Všimněte si, že složky ve vzdálené cestě k souboru musí existovat.

Následující požadavek ukazuje službu BITS, která předá nahraný soubor serverové aplikaci v textu požadavku.

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

Následující odpověď ukazuje serverovou aplikaci, která předává data odpovědí službě BITS v textu odpovědi.

HTTP/1.1 200 - OK
Content-Length: 100

100 bytes of reply data goes here

Zpracování chyb serverových aplikací

Viz zpracování chyb aplikace serveru.