Sunucu Uygulamaları için Bildirim Protokolü

BITS, BITS'nin karşıya yükleme dosyasının içeriğini sunucu uygulamasına nasıl gönderdiğini belirlemek için BITSServerNotificationType özelliğini kullanır. BITSServerNotificationType özelliği 1 olarak ayarlanırsa, BITS karşıya yükleme dosyasının konumunubir üst bilgide geçirir. BITSServerNotificationType özelliği 2 olarak ayarlanırsa, BITS karşıya yükleme dosyasının içeriğini istekgövdesine geçirir.

BITS'nin sunucu uygulamasındaki hataları nasıl işlediğiyle ilgili ayrıntılar için bkz. sunucu uygulaması hatalarını işleme.

Karşıya yükleme dosyasının konumunu üst bilgide gönderme

BITSServerNotificationType özelliği 1 olarak ayarlandıysa, BITS, yükleme ve yanıt dosyalarının konumunu üst bilgilerde sunucu uygulamasına geçirir. Sunucu uygulaması karşıya yükleme dosyasını açar, verileri işler ve ardından yanıt dosyasını oluşturur. Varsayılan olarak BITS, sunucu uygulamasından yanıt aldıktan sonra karşıya yükleme ve yanıt dosyalarını sunucudan kaldırır. BITS'nin karşıya yükleme dosyasını işteki uzak dosya adı tarafından belirtilen konuma kopyalamasını sağlamak için, yanıtınıza BITS-Copy-File-To-Destination üst bilgisini ekleyin. Üst bilgiyi eklemezseniz ve karşıya yükleme ve yanıt dosyalarını kaydetmek istiyorsanız, yanıtlamadan önce karşıya yükleme ve yanıtlama dosyalarını yeni bir konuma kopyalamanız gerekir. Aşağıdaki tabloda istek üst bilgileri gösterilmektedir.

İstek üst bilgisi	Açıklama
BITS-Original-Request-URL	İşte belirtilen uzak adı içerir.
BITS-İstek-DataFile-Name	Karşıya yüklenen verilerin tam yolunu içerir.
BITS-Yanıt-DataFile-Name	BITS'nin sunucu uygulamasının yanıtı yazmasını beklediği tam yolu içerir.

Aşağıdaki tabloda yanıt üst bilgileri gösterilmektedir.

Yanıt üst bilgisi	Açıklama
BITS-Statik-Response-URL	Opsiyonel. Yanıt olarak kullanılacak statik veri dosyasının mutlak URL'sini (göreli URL belirtmeyin) içerir. Statik veri dosyasına BITS istemcisi tarafından erişilebilir olmalıdır. Bu üst bilgiyi kullanırsanız, BITS-Response-DataFile-Name istek üst bilgisinde belirtilen yanıt dosyasını oluşturmayın. BITS'in bu dosyayı sizin için silmediğini unutmayın.
BITS-Copy-File-To-Destination	Opsiyonel. Varsayılan olarak, BITSServerNotificationType özelliği 1 veya 2 olarak ayarlanırsa, BITS sunucusu karşıya yükleme dosyasını işteki uzak dosya adı tarafından belirtilen konuma kopyalamaz. BITS'nin dosyayı işteki uzak dosya adıyla belirtilen konuma kopyalamasını sağlamak için bu yanıt üst bilgisini gönderin. Herhangi bir değer belirtebilirsiniz; BITS değeri kullanmaz. Uzak dosya yolundaki klasörlerin mevcut olması gerektiğini unutmayın.

Aşağıdaki istek, sunucu uygulamasına karşıya yükleme dosyasının konumunu gönderen BITS'yi gösterir.

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

Aşağıda sunucu uygulamasının BITS'ye yanıtı gösterilmektedir; yanıt, BITS-Response-DataFile-Name istek üst bilgisi tarafından belirtilen dosyaya yerleştirilir.

HTTP/1.1 200 - OK
Content-Length: 0

Karşıya yükleme dosyasını isteğin gövdesine gönderme

BITSServerNotificationType özelliği 2 olarak ayarlandıysa, BITS karşıya yükleme dosyasını isteğin gövdesine gönderir. Karşıya yükleme dosyasını isteğin gövdesine göndermek, mevcut betiklerin ve uygulamaların en az değişiklikle çalışmasını sağlar. Karşıya yükleme dosyası ve yanıt dosyası sırasıyla istek ve yanıtta geçirilir. Aşağıdaki tabloda istek üst bilgisi gösterilmektedir.

İstek üst bilgisi	Açıklama
BITS-Original-Request-URL	İşte belirtilen uzak adı içerir.

Aşağıdaki tabloda yanıt üst bilgileri gösterilmektedir.

Yanıt üst bilgisi	Açıklama
BITS-Statik-Response-URL	Opsiyonel. Yanıt olarak kullanılacak statik veri dosyasının mutlak URL'sini (göreli URL belirtmeyin) içerir. Statik veri dosyasına BITS istemcisi tarafından erişilebilir olmalıdır. Bu üst bilgiyi kullanırsanız, yanıtı akışa eklemeyin. BITS'in bu dosyayı sizin için silmediğini unutmayın.
BITS-Copy-File-To-Destination	Opsiyonel. BITSServerNotificationType özelliği 1 veya 2 olarak ayarlanırsa, BITS sunucusu karşıya yükleme dosyasını işteki uzak dosya adı tarafından belirtilen konuma kopyalamaz. BITS'nin dosyayı uzak dosya adıyla belirtilen konuma kopyalamasını sağlamak için bu yanıt üst bilgisini gönderin. Herhangi bir değer belirtebilirsiniz; BITS değeri kullanmaz. Uzak dosya yolundaki klasörlerin mevcut olması gerektiğini unutmayın.

Aşağıdaki istek, karşıya yüklenen dosyayı isteğin gövdesindeki sunucu uygulamasına geçiren BITS'yi gösterir.

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

Aşağıdaki yanıt, yanıt gövdesindeki BITS'ye yanıt verilerini geçiren sunucu uygulamasını gösterir.

HTTP/1.1 200 - OK
Content-Length: 100

100 bytes of reply data goes here

Sunucu uygulaması hatalarını işleme

Bkz. Sunucu Uygulama Hatalarını İşleme.