ACK pour Cancel-Session
Utilisez le paquet ACK pour annuler la session pour accuser réception de la demande d' annulation de session du client. Le serveur envoie l’accusé de réception après avoir libéré toutes les ressources associées à la session de téléchargement.
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
headers
-
Reason-Code
-
Remplacez Reason-Code par le code de raison HTTP. Par exemple, affectez la valeur 200 à code de raison en cas de réussite. Pour obtenir la liste des codes de raison HTTP, consultez la RFC 2616.
-
raison-Description
-
Remplacez Reason-Description par la description HTTP associée au code de raison. Par exemple, affectez à Reason-Description la valeur OK si code de raison est 200.
-
BITS-Packet-type
-
Identifie ce paquet de réponse comme un paquet ACK.
-
ID de session BITS
-
GUID de chaîne qui identifie la session sur le client. Remplacez {GUID} par l’identificateur de session que le client a envoyé dans le paquet de demande d' annulation de session . Si vous ne reconnaissez pas l’identificateur de session, définissez l’en-tête BITS-error-code sur BG _ E _ session _ _ introuvable.
-
Content-Length
-
Remplacez length par le nombre d’octets inclus dans le corps de la réponse. Obligatoire même si le corps de la réponse n’inclut pas de contenu.
-
BITS-erreur-code
-
Remplacez error-code par un nombre hexadécimal qui représente une valeur HRESULT associée à une erreur côté serveur. N’incluez cet en-tête que si la raison-code n’est pas 200 ou 201.
-
BITS-erreur-contexte
-
Remplacez erreur-Context par un nombre hexadécimal qui représente le contexte dans lequel l’erreur s’est produite. Spécifiez le nombre hexadécimal pour BG_ERROR_CONTEXT_REMOTE_FILE (0x5) si le serveur a généré l’erreur. Dans le cas contraire, spécifiez le nombre hexadécimal pour l' _ _ _ _ application distante du contexte d’erreur BG (0x7) si l’erreur a été générée par l’application dans laquelle le fichier de téléchargement est transmis. Incluez cet en-tête uniquement si le code de raison n’est pas 200 ou 201.
Remarques
Le client BITS renvoie le paquet d' annulation de session si le code de raison est compris entre 500 et 599, sauf si l’en-tête de code d’erreur bits est présent avec la valeur BG _ E _ session _ _ introuvable. Le client n’effectue pas de nouvelle tentative pour les codes de raison 100 à 499.