Поделиться через


Ack for Close-Session

Используйте пакет Ack for Close-Session, чтобы подтвердить запрос клиента Close-Session . Сервер отправляет подтверждение после освобождения всех ресурсов, связанных с сеансом отправки.

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

Заголовки

reason-code

Замените reason-code кодом причины HTTP. Например, задайте для reason-code значение 200 в случае успешного выполнения. Список кодов причин HTTP см. в статье RFC 2616.

reason-description

Замените reason-description описанием HTTP, связанным с кодом причины. Например, задайте для параметра reason-description значение ОК, если аргумент reason-code равен 200.

Bits-packet-type

Определяет этот пакет ответа как пакет Ack.

BITS-Session-Id

Строковый GUID, определяющий сеанс для клиента. Замените {guid} идентификатором сеанса, который клиент отправил в пакете запроса Close-Session . Если идентификатор сеанса не распознается, задайте для заголовка BITS-Error-Code значение BG_E_SESSION_NOT_FOUND.

Длина содержимого

Замените length числом байтов, включенных в текст ответа. Длина содержимого является обязательной, даже если текст ответа не содержит содержимого.

BITS-error-code

Замените код ошибки шестнадцатеричным числом, представляющим значение HRESULT, связанное с ошибкой на стороне сервера. Этот заголовок следует включать только в том случае, если аргумент reason-code не равен 200 или 201.

BITS-Error-Context

Замените error-context шестнадцатеричным числом, представляющим контекст, в котором произошла ошибка. Укажите шестнадцатеричное число для BG_ERROR_CONTEXT_REMOTE_FILE (0x5), если сервер создал ошибку. В противном случае укажите шестнадцатеричное число для BG_ERROR_CONTEXT_REMOTE_APPLICATION (0x7), если ошибка была создана приложением, в которое передается файл отправки. Этот заголовок следует включать только в том случае, если аргумент reason-code не равен 200 или 201.

Комментарии

Клиент BITS повторно отправляет пакет Close-Session , если аргумент reason-code находится в диапазоне от 500 до 599, если только заголовок BITS-Error-Code не имеет значения BG_E_SESSION_NOT_FOUND. Клиент не будет повторять попытки по причинам с кодами от 100 до 499.

См. также раздел

Ack for Cancel-Session

Закрытие сеанса