Ack for Close-Session

Usare il pacchetto Ack for Close-Session per riconoscere la richiesta Close-Session del client. Il server invia il riconoscimento dopo il rilascio di tutte le risorse associate alla sessione di caricamento.

reason-code reason-description
BITS-Packet-Type: Ack
BITS-Session-Id: {guid}
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. Ad esempio, impostare il codice motivo su 200 se ha esito positivo. Per un elenco di codici motivo HTTP, vedere RFC 2616.

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-Session-ID

GUID stringa che identifica la sessione al client. Sostituire {guid} con l'identificatore di sessione inviato dal client nel pacchetto di richiesta Close-Session . Se non si riconosce l'identificatore della sessione, impostare l'intestazione BITS-Error-Code su BG_E_SESSION_NOT_FOUND.

Lunghezza contenuto

Sostituire la lunghezza con il numero di byte inclusi nel corpo della risposta. La lunghezza del contenuto è necessaria, 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.

Commenti

Il client BITS invia nuovamente il pacchetto Close-Session se il codice motivo si trova nell'intervallo da 500 a 599, a meno che l'intestazione BITS-Error-Code non sia presente con un valore di BG_E_SESSION_NOT_FOUND. Il client non riprova per i codici motivo da 100 a 499.

Vedi anche

Ack for Cancel-Session

Close-Session