Create-Session

Use the Create-Session packet to request an upload session with the BITS server.

BITS_POST remote-URL HTTP/1.1
BITS-Packet-Type: Create-Session
BITS-Supported-Protocols: {guid1} ... {guidN}

Headers

  • BITS_POST
    BITS-specific verb that identifies this packet to the BITS server.

    Replace remote-URL with the absolute or relative URI. Typically, replace remote-URL with the remote file name of the job. For network load balancing considerations, see the BITS-Host-Id header.

  • BITS-Packet-Type
    Identifies this request packet as a Create-Session packet.

  • BITS-Supported-Protocols
    Space-delimited list of the protocols that the client supports. Use string GUIDs to identify the protocols. Specify the list in order of preference from most to least preferred. The following table lists the protocol that the BITS client supports. Replace {guid1} ... {guidN} with one or more string GUIDs from the list.

    Protocol Description

    {7df0354d-249b-430f-820d-3d2a9bef4931}

    BITS 1.5 Upload Protocol

     

Remarks

You should send a Ping packet to establish an HTTP connection before sending the Create-Session packet. The Create-Session packet can also establish the connection; however, the Create-Session packet is less efficient.

The server selects the protocol it wants to use from the list the client provides in the BITS-Supported-Protocols header. The server returns the selected protocol in the BITS-Protocol header of the Ack for Create-Session response packet.

The client expects the server to return an Ack for Create-Session response packet. If the server was able to establish a session, the client uses the Fragment request packet to send ranges of the file to the server.

See also

Ack for Create-Session

Fragment

Ping