Partager via


Ack pour Create-Session

Utilisez le paquet Ack for Create-Session pour accuser réception de la demande Create-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

En-têtes

reason-code

Remplacez le code de raison par le code de raison HTTP. Le tableau suivant montre les codes de raison typiques d’une réponse à une demande Create-Session . Pour obtenir la liste des codes de motif HTTP, consultez 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 dans 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é.

description de la raison

Remplacez la description de la raison par la description HTTP associée au code de raison. Par exemple, définissez la description de la raison sur OK si le code de raison est 200.

BITS-Packet-Type

Identifie ce paquet de réponse en tant que paquet Ack.

BITS-Protocol

GUID de chaîne qui identifie le protocole que le serveur souhaite utiliser pour cette session. Remplacez {guid} par l’identificateur de protocole de la liste des protocoles que le client inclut dans la demande Créer une 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.

BITS-Session-ID

GUID de chaîne qui identifie cette session au client. Remplacez {guid} par l’identificateur de session que le client envoie dans tous les paquets de requête suivants.

BITS utilise un GUID pour identifier la session, mais vous pouvez utiliser n’importe quelle chaîne http légale jusqu’à 100 caractères.

BITS-Host-ID

Optionnel. N’incluez cet en-tête que si la propriété d’extension BITS IIS, 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 recommence sur un autre serveur de la batterie de serveurs, laissant un fichier de chargement partiel sur le serveur précédent.

BITS-Host-Id-Fallback-Timeout

Optionnel. Incluez cet en-tête uniquement si l’en-tête BITS-Host-Id est spécifié. Remplacez Timeout par la valeur de 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 de 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. Le minuteur commence lorsque BITS ne peut pas se connecter au serveur BITS-Host-ID. Le minuteur est réinitialisé lorsqu’une connexion au serveur est restaurée. Si aucun délai d’attente n’est spécifié, le client ne revient jamais au nom d’hôte spécifié dans le nom du fichier distant.

Accepter l’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 nécessite un encodage d’identité (texte en clair). Incluez cet en-tête uniquement si le code raison est 200 ou 201.

Longueur du contenu

Remplacez la longueur 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-Error-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-Error-Context

Remplacez error-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. Sinon, spécifiez le nombre hexadécimal pour BG_ERROR_CONTEXT_REMOTE_APPLICATION (0x7) si l’erreur a été générée par l’application à laquelle le fichier de chargement est passé. Incluez cet en-tête uniquement si le code de raison n’est pas 200 ou 201.

Voir aussi

Créer une session