Ack for Create-Session
Usare il pacchetto Ack for Create-Session per riconoscere la richiesta Create-Session del client.
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
Intestazioni
-
reason-code
-
Sostituire il codice motivo con il codice motivo HTTP. Nella tabella seguente vengono illustrati i codici motivo tipici per una risposta a una richiesta Create-Session . Per un elenco di codici motivo HTTP, vedere RFC 2616.
Codice motivo Descrizione 200 OK. La richiesta è stata completata. 201 Creazione riuscita. La sessione è stata creata. 403 Non consentito. L'utente non è autorizzato a caricare file nell'URL specificato. 404 Non trovato. L'URL specificato non esiste. 409 Conflitto. Il file esiste nel server e non può essere sovrascritto. -
reason-description
-
Sostituire la descrizione motivo con la descrizione HTTP associata al codice motivo. Impostare ad esempio la descrizione motivo su OK se il codice motivo è 200.
-
BITS-Packet-Type
-
Identifica questo pacchetto di risposta come pacchetto Ack.
-
BITS-Protocol
-
GUID stringa che identifica il protocollo che il server vuole usare per questa sessione. Sostituire {guid} con l'identificatore di protocollo dall'elenco dei protocolli inclusi nella richiesta Create-Session ; l'intestazione BITS-Supported-Protocol contiene l'elenco. Includere questa intestazione solo se il codice motivo è 200 o 201.
-
BITS-Session-ID
-
GUID stringa che identifica questa sessione al client. Sostituire {guid} con l'identificatore di sessione inviato dal client in tutti i pacchetti di richiesta successivi.
BITS usa un GUID per identificare la sessione, ma è possibile usare qualsiasi stringa legale HTTP fino a 100 caratteri.
-
BITS-Host-ID
-
Facoltativa. Includere questa intestazione solo se la proprietà dell'estensione IIS BITS, BITSHostId, è impostata. Sostituire PublicHostName con il nome del server o l'indirizzo IP dalla proprietà BITSHostId.
Il client deve sostituire la parte del server dell'URL remoto in tutti i pacchetti successivi. Se il client non specifica questo nome host nei pacchetti successivi, è possibile che il processo inizierà nuovamente in un altro server della farm, lasciando un file di caricamento parziale nel server precedente.
-
BITS-Host-Id-Fallback-Timeout
-
Facoltativa. Includere questa intestazione solo se è specificata l'intestazione BITS-Host-Id. Sostituire Timeout con il valore di timeout dalla proprietà BITSHostIdFallbackTimeout. La proprietà BITSHostIdFallbackTimeout è una delle proprietà dell'estensione IIS BITS.
Il client usa il periodo di timeout per determinare quanto tempo tenta di riconnettersi al nome del server specificato nell'intestazione BITS-Host-ID prima di ripristinare il nome host specificato nel nome file remoto del processo. Il timer inizia quando BITS non è in grado di connettersi al server BITS-Host-Id. Il timer viene reimpostato quando viene ripristinata una connessione al server. Se non viene specificato un periodo di timeout, il client non ripristina mai il nome host specificato nel nome del file remoto.
-
Accept-Encoding
-
Identifica lo schema di codifica da usare nei frammenti inviati al server. Il pacchetto Fragment contiene il frammento codificato nel corpo del pacchetto. Il server BITS richiede la codifica Identity (testo non crittografato). Includere questa intestazione solo se il codice Reason è 200 o 201.
-
Lunghezza contenuto
-
Sostituire la lunghezza con il numero di byte inclusi nel corpo della risposta. Obbligatorio anche se il corpo della risposta non include contenuto.
-
BITS-Error-Code
-
Sostituire il codice di errore con un numero esadecimale che rappresenta un valore HRESULT associato a un errore lato server. Includere questa intestazione solo se il codice motivo non è 200 o 201.
-
BITS-Error-Context
-
Sostituire il contesto di errore con un numero esadecimale che rappresenta il contesto in cui si è verificato l'errore. Specificare il numero esadecimale per BG_ERROR_CONTEXT_REMOTE_FILE (0x5 ) se il server ha generato l'errore. In caso contrario, specificare il numero esadecimale per BG_ERROR_CONTEXT_REMOTE_APPLICATION (0x7 ) se l'errore è stato generato dall'applicazione a cui viene passato il file di caricamento. Includere questa intestazione solo se il codice motivo non è 200 o 201.