Ack para Create-Session
Use o pacote Ack for Create-Session para confirmar a solicitação Create-Session do cliente.
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
Cabeçalhos
-
reason-code
-
Substitua reason-code pelo código de motivo HTTP. A tabela a seguir mostra os códigos de motivo típicos para uma resposta a uma solicitação Create-Session . 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. 201 Criado. A sessão foi criada. 403 Negado. O usuário não tem permissão para carregar arquivos na URL especificada. 404 Não encontrado. A URL especificada não existe. 409 Conflito. O arquivo existe no servidor e não pode ser substituído. -
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.
-
Protocolo BITS
-
GUID de cadeia de caracteres que identifica o protocolo que o servidor deseja usar para esta sessão. Substitua {guid} pelo identificador de protocolo da lista de protocolos que o cliente inclui na solicitação Create-Session ; o cabeçalho BITS-Supported-Protocol contém a lista. Inclua esse cabeçalho somente se o código-motivo for 200 ou 201.
-
BITS-Session-Id
-
GUID de cadeia de caracteres que identifica essa sessão para o cliente. Substitua {guid} pelo identificador de sessão que o cliente envia em todos os pacotes de solicitação subsequentes.
O BITS usa um GUID para identificar a sessão, mas você pode usar qualquer cadeia de caracteres http-legal de até 100 caracteres.
-
BITS-Host-Id
-
Opcional. Inclua esse cabeçalho somente se a propriedade de extensão IIS do BITS, BITSHostId, estiver definida. Substitua PublicHostName pelo nome do servidor ou endereço IP da propriedade BITSHostId.
O cliente deve substituir a parte do servidor da URL remota em todos os pacotes subsequentes. Se o cliente não especificar esse nome de host em pacotes subsequentes, é possível que o trabalho comece novamente em outro servidor no farm, deixando um arquivo de upload parcial no servidor anterior.
-
BITS-Host-Id-Fallback-Timeout
-
Opcional. Inclua esse cabeçalho somente se o cabeçalho BITS-Host-Id for especificado. Substitua Timeout pelo valor de tempo limite da propriedade BITSHostIdFallbackTimeout. A propriedade BITSHostIdFallbackTimeout é uma das propriedades de extensão do IIS do BITS.
O cliente usa o período de tempo limite para determinar por quanto tempo tenta se reconectar ao nome do servidor especificado no cabeçalho BITS-Host-Id antes de reverter para o nome do host especificado no nome do arquivo remoto do trabalho. O temporizador começa quando o BITS não consegue se conectar ao servidor BITS-Host-Id. O temporizador é redefinido quando uma conexão com o servidor é restaurada. Se um período de tempo limite não for especificado, o cliente nunca será revertido para o nome do host especificado no nome do arquivo remoto.
-
Aceitação de codificação
-
Identifica o esquema de codificação a ser usado nos fragmentos enviados ao servidor. O pacote Fragment contém o fragmento codificado no corpo do pacote. O servidor BITS requer codificação de identidade (texto não criptografado). Inclua esse cabeçalho somente se o Código de motivo for 200 ou 201.
-
Comprimento do conteúdo
-
Substitua length pelo número de bytes incluídos no corpo da resposta. Obrigató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 de 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.