ACK pour Create-Session

Utilisez le paquet ACK pour Create-session pour accuser réception de la demande de création de session du client.

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

headers

Reason-Code

Remplacez Reason-Code par le code de raison HTTP. Le tableau suivant présente les codes de raison typiques d’une réponse à une demande de création de session . Pour obtenir la liste des codes de raison HTTP, consultez la RFC 2616.

Code de la raison Description
200
OK. La demande a abouti.
201
Créé. La session a été créée.
403
Interdit. L’utilisateur n’est pas autorisé à charger des fichiers sur l’URL spécifiée.
404
Introuvable. L’URL spécifiée n’existe pas.
409
Conflit. Le fichier existe sur le serveur et ne peut pas être remplacé.

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.

BITS-protocole

GUID de chaîne qui identifie le protocole que le serveur souhaite utiliser pour cette session. Remplacez {GUID} par l’identificateur de protocole dans la liste des protocoles que le client contient dans la demande de création de session ; l’en-tête BITS-Supported-Protocol contient la liste. Incluez cet en-tête uniquement si le code de raison est 200 ou 201.

ID de session BITS

GUID de chaîne qui identifie cette session sur le client. Remplacez {GUID} par l’identificateur de session que le client envoie dans tous les paquets de demande suivants.

BITS utilise un GUID pour identifier la session, mais vous pouvez utiliser n’importe quelle chaîne HTTP-Legal jusqu’à 100 caractères.

BITS-Host-ID

Facultatif. Incluez cet en-tête uniquement si la propriété d’extension IIS bits, BITSHostId, est définie. Remplacez PublicHostName par le nom du serveur ou l’adresse IP de la propriété BITSHostId.

Le client doit remplacer la partie serveur de l’URL distante sur tous les paquets suivants. Si le client ne spécifie pas ce nom d’hôte sur les paquets suivants, il est possible que le travail redémarre sur un autre serveur de la batterie, laissant ainsi un fichier de téléchargement partiel sur le serveur précédent.

BITS-Host-ID-repli-Timeout

Facultatif. Incluez cet en-tête uniquement si l’en-tête BITS-Host-ID est spécifié. Remplacez Timeout par la valeur du délai d’attente de la propriété BITSHostIdFallbackTimeout. La propriété BITSHostIdFallbackTimeout est l’une des propriétés d’extension IIS bits.

Le client utilise le délai d’expiration pour déterminer la durée pendant laquelle il tente de se reconnecter au nom du serveur spécifié dans l’en-tête BITS-Host-ID avant de revenir au nom d’hôte spécifié dans le nom de fichier distant du travail. La minuterie commence lorsque BITS ne parvient pas à se connecter au serveur BITS-Host-ID. La minuterie est réinitialisée lors de la restauration d’une connexion au serveur. Si aucun délai d’attente n’est spécifié, le client ne retourne jamais au nom d’hôte spécifié dans le nom de fichier distant.

Accepter-encodage

Identifie le schéma d’encodage à utiliser sur les fragments envoyés au serveur. Le paquet fragment contient le fragment encodé dans le corps du paquet. Le serveur BITS requiert l’encodage d’identité (texte en clair). Incluez cet en-tête uniquement si le code de raison est 200 ou 201.

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. Incluez cet en-tête uniquement si le code de raison 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 du _ _ _ _ fichier distant de contexte d’erreur BG (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.

Voir aussi

Créer une session