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
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
