Compartilhar via


Ack para Close-Session

Use o pacote Ack for Close-Session para reconhecer a solicitação close-session do cliente. O servidor envia a confirmação depois de liberar todos os recursos associados à sessão de upload.

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

Cabeçalhos

reason-code

Substitua reason-code pelo código de motivo HTTP. Por exemplo, defina reason-code como 200 se for bem-sucedido. Para obter uma lista de códigos de motivo HTTP, consulte RFC 2616.

reason-description

Substitua reason-description pela descrição HTTP associada ao código de motivo. Por exemplo, defina reason-description como OK se reason-code for 200.

BITS-Packet-Type

Identifica esse pacote de resposta como um pacote Ack.

BITS-Session-Id

GUID de cadeia de caracteres que identifica a sessão para o cliente. Substitua {guid} pelo identificador de sessão que o cliente enviou no pacote de solicitação Close-Session . Se você não reconhecer o identificador de sessão, defina o cabeçalho BITS-Error-Code como BG_E_SESSION_NOT_FOUND.

Comprimento do conteúdo

Substitua length pelo número de bytes incluídos no corpo da resposta. Content-Length é necessário, mesmo que o corpo da resposta não inclua conteúdo.

BITS-Error-Code

Substitua error-code por um número hexadecimal que representa um valor HRESULT associado a um erro do lado do servidor. Inclua esse cabeçalho somente se reason-code não for 200 ou 201.

BITS-Error-Context

Substitua error-context por um número hexadecimal que representa o contexto no qual o erro ocorreu. Especifique o número hexadecimal para BG_ERROR_CONTEXT_REMOTE_FILE (0x5) se o servidor gerou o erro. Caso contrário, especifique o número hexadecimal para BG_ERROR_CONTEXT_REMOTE_APPLICATION (0x7) se o erro tiver sido gerado pelo aplicativo para o qual o arquivo de carregamento é passado. Inclua esse cabeçalho somente se o código de motivo não for 200 ou 201.

Comentários

O cliente BITS reenviará o pacote Close-Session se o código-motivo estiver no intervalo de 500 a 599, a menos que o cabeçalho BITS-Error-Code esteja presente com um valor de BG_E_SESSION_NOT_FOUND. O cliente não tentará novamente por códigos de motivo 100 a 499.

Confira também

Ack para Cancel-Session

Fechar sessão