Ack para Cancel-Session

Use el paquete Ack for Cancel-Session para confirmar la solicitud Cancel-Session del cliente. El servidor envía la confirmación después de liberar todos los recursos asociados a la sesión de carga.

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

encabezados

código de motivo

Reemplace reason-code por el código de motivo HTTP. Por ejemplo, establezca el código de motivo en 200 si se realiza correctamente. Para obtener una lista de códigos de motivo HTTP, consulte RFC 2616.

reason-description

Reemplace reason-description por la descripción HTTP asociada al código de motivo. Por ejemplo, establezca reason-description en Ok si el código de motivo es 200.

BITS-Packet-Type

Identifica este paquete de respuesta como un paquete Ack.

BITS-Session-Id

GUID de cadena que identifica la sesión al cliente. Reemplace {guid} por el identificador de sesión que el cliente envió en el paquete de solicitud Cancel-Session . Si no reconoce el identificador de sesión, establezca el encabezado BITS-Error-Code en BG_E_SESSION_NOT_FOUND.

Longitud del contenido

Reemplace length por el número de bytes incluidos en el cuerpo de la respuesta. Necesario incluso si el cuerpo de la respuesta no incluye contenido.

BITS-Error-Code

Reemplace el código de error por un número hexadecimal que representa un valor HRESULT asociado a un error del lado servidor. Incluya solo este encabezado si el código de motivo no es 200 o 201.

BITS-Error-Context

Reemplace error-context por un número hexadecimal que representa el contexto en el que se produjo el error. Especifique el número hexadecimal para BG_ERROR_CONTEXT_REMOTE_FILE (0x5) si el servidor generó el error. De lo contrario, especifique el número hexadecimal para BG_ERROR_CONTEXT_REMOTE_APPLICATION (0x7) si la aplicación ha generado el error al que se pasa el archivo de carga. Incluya este encabezado solo si el código de motivo no es 200 o 201.

Comentarios

El cliente BITS vuelve a enviar el paquete Cancel-Session si el código de motivo está en el intervalo comprendido entre 500 y 599, a menos que el encabezado BITS-Error-Code esté presente con un valor de BG_E_SESSION_NOT_FOUND. El cliente no volverá a intentarlo por los códigos de motivo de 100 a 499.

Consulte también

Ack for Close-Session

Cancelar sesión