Cancel-Session
Use o pacote Cancel-Session para encerrar a sessão de upload com o servidor BITS.
BITS_POST remote-URL HTTP/1.1
BITS-Packet-Type: Cancel-Session
BITS-Session-Id: {guid}
Cabeçalhos
-
BITS_POST
-
Verbo específico do BITS que identifica esse pacote para o servidor BITS.
Substitua remote-URL pelo URI absoluto ou relativo. Normalmente, substitua remote-URL pelo nome de arquivo remoto do trabalho. Para considerações de balanceamento de carga de rede, consulte o cabeçalho BITS-Host-Id no pacote Create-Session .
-
Bits-Packet-Type
-
Identifica esse pacote de solicitação como um pacote Cancel-Session.
-
BITS-Session-Id
-
GUID de cadeia de caracteres que identifica a sessão para o servidor. Substitua {guid} pelo identificador de sessão que o servidor retorna no pacote de resposta Ack for Create-Session .
Comentários
Esse pacote cancelará um trabalho de upload se ele for enviado antes do último fragmento ser enviado. Cancel-Session não tem efeito sobre um arquivo cujo último fragmento já foi enviado. Quando o servidor BITS recebe o último fragmento, ele grava o arquivo em seu destino final e, no caso de uma resposta de upload, posta o arquivo no aplicativo do servidor. No caso de upload-reply, o pacote Cancel-Session cancela a parte de resposta de um trabalho de upload-reply.
O servidor BITS libera todos os recursos e exclui todos os arquivos temporários quando recebe esse pacote.
O cliente BITS envia esse pacote quando o usuário cancela o trabalho.
Confira também