Ack para Fragment
Use o pacote Ack for Fragment para reconhecer a solicitação fragment do cliente.
reason-code reason-description
BITS-Packet-Type: Ack
BITS-Session-Id: {guid}
BITS-Received-Content-Range: range
BITS-Reply-URL: url
Content-Length: length
BITS-Error-Code: error-code
BITS-Error-Context: error-context
Cabeçalhos
-
reason-code
-
Substitua reason-code por um código de motivo HTTP. A tabela a seguir mostra os códigos de motivo típicos para uma resposta a uma solicitação fragmentada . Para obter uma lista de códigos de motivo HTTP, consulte RFC 2616.
Código do motivo Descrição 200 OK. A solicitação foi bem-sucedida. 416 Intervalo não satisfiável. O cliente enviou um fragmento cujo intervalo não é contíguo com o fragmento anterior. -
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-Received-Content-Range
-
Deslocamento baseado em zero para o próximo byte que o servidor espera que o cliente envie. Por exemplo, se o fragmento contivesse o intervalo 128 212, você definiria o intervalo como 213.
-
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 fragmentado . Se você não reconhecer o identificador de sessão, defina o cabeçalho BITS-Error-Code como BG_E_SESSION_NOT_FOUND.
-
BITS-Reply-URL
-
Contém a URL para os dados de resposta de um trabalho de upload-reply. Inclua esse cabeçalho na resposta final do fragmento após a conclusão do upload e você receberá uma resposta do aplicativo de servidor, se aplicável.
Use o cabeçalho Content-Range da solicitação Fragment para determinar se o upload foi concluído. O upload será concluído se o deslocamento final do valor do intervalo for igual ao valor de comprimento total menos um.
O servidor BITS posta o arquivo de upload no aplicativo do servidor depois de determinar que o upload foi concluído. O aplicativo de servidor processa o arquivo e gera a resposta. O servidor BITS define o valor de BITS-Reply-URL como a URL do arquivo de resposta do aplicativo de servidor.
-
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 o código-motivo 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 foi gerado pelo aplicativo para o qual o arquivo de upload é passado. Inclua esse cabeçalho somente se o código-motivo não for 200 ou 201.
Comentários
Se a sessão for para um trabalho de upload-reply, pode haver um atraso antes que o cliente receba a resposta final do Ack for Fragment . A duração do atraso depende do tempo que o aplicativo de servidor (aplicativo para o qual o servidor posta o arquivo de carregamento) leva para gerar a resposta.