Ack para Create-Session
Use el paquete Ack for Create-Session para confirmar la solicitud Create-Session del 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
encabezados
-
código de motivo
-
Reemplace reason-code por el código de motivo HTTP. En la tabla siguiente se muestran los códigos de motivo típicos de una respuesta a una solicitud Create-Session . Para obtener una lista de códigos de motivo HTTP, consulte RFC 2616.
Código del motivo Descripción 200 Aceptar. La solicitud fue correcta. 201 Creado. Se creó la sesión. 403 Prohibido. El usuario no puede cargar archivos en la dirección URL especificada. 404 Not Found. La dirección URL especificada no existe. 409 Conflicto. El archivo existe en el servidor y no se puede sobrescribir. -
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.
-
PROTOCOLO BITS
-
GUID de cadena que identifica el protocolo que el servidor quiere usar para esta sesión. Reemplace {guid} por el identificador de protocolo de la lista de protocolos que el cliente incluye en la solicitud Create-Session ; El encabezado BITS-Supported-Protocol contiene la lista. Incluya este encabezado solo si el código de motivo es 200 o 201.
-
BITS-Session-Id
-
GUID de cadena que identifica esta sesión al cliente. Reemplace {guid} por el identificador de sesión que el cliente envía en todos los paquetes de solicitud posteriores.
BITS usa un GUID para identificar la sesión, pero puede usar cualquier cadena legal HTTP de hasta 100 caracteres.
-
BITS-Host-Id
-
Opcional. Incluya este encabezado solo si se establece la propiedad de extensión BITS IIS, BITSHostId. Reemplace PublicHostName por el nombre del servidor o la dirección IP de la propiedad BITSHostId.
El cliente debe reemplazar la parte del servidor de la dirección URL remota en todos los paquetes posteriores. Si el cliente no especifica este nombre de host en paquetes posteriores, es posible que el trabajo se inicie de nuevo en otro servidor de la granja de servidores, dejando un archivo de carga parcial en el servidor anterior.
-
BITS-Host-Id-Fallback-Timeout
-
Opcional. Incluya este encabezado solo si se especifica el encabezado BITS-Host-Id. Reemplace Timeout por el valor de tiempo de espera de la propiedad BITSHostIdFallbackTimeout. La propiedad BITSHostIdFallbackTimeout es una de las propiedades de extensión de IIS de BITS.
El cliente usa el período de tiempo de espera para determinar cuánto tiempo intenta volver a conectarse al nombre del servidor especificado en el encabezado BITS-Host-Id antes de revertir al nombre de host especificado en el nombre de archivo remoto del trabajo. El temporizador comienza cuando BITS no puede conectarse al servidor BITS-Host-Id. El temporizador se restablece cuando se restaura una conexión al servidor. Si no se especifica un período de tiempo de espera, el cliente nunca vuelve al nombre de host especificado en el nombre de archivo remoto.
-
Accept-Encoding
-
Identifica el esquema de codificación que se va a usar en los fragmentos enviados al servidor. El paquete Fragment contiene el fragmento codificado en el cuerpo del paquete. El servidor BITS requiere codificación de identidad (texto no cifrado). Incluya este encabezado solo si el código de motivo es 200 o 201.
-
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 este encabezado solo 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.