Méthode IBackgroundCopyJobHttpOptions2 ::SetHttpMethod (bits10_2.h)

Remplace la méthode HTTP par défaut utilisée pour un transfert BITS.

Syntaxe

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

Paramètres

[in] method

Type : LPCWSTR

Pointeur vers une chaîne null constante de caractères larges contenant le nom de la méthode HTTP.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

BITS vous permet, en tant que développeur, de choisir une méthode HTTP autre que la méthode par défaut. Cela augmente la capacité de BITS à interagir avec les serveurs qui ne respectent pas les exigences BITS normales pour les serveurs HTTP. Gardez à l’esprit ce qui suit lorsque vous choisissez une autre méthode HTTP que celle par défaut.

• BITS modifie automatiquement la priorité du travail en BG_JOB_PRIORITY_FOREGROUND et empêche cette priorité d’être modifiée.
• Une erreur qui peut normalement être reprise (telle qu’une perte de connectivité) fait passer le travail à un état ERROR. En tant que développeur, vous pouvez redémarrer le travail en appelant IBackgroundCopyJob ::Resume, et le travail sera redémarré à partir du début. Pour plus d’informations sur les états du travail BITS, consultez Cycle de vie d’un travail BITS .
• BITS n’autorise pas DYNAMIC_CONTENT ni ON_DEMAND_MODE travaux avec SetHttpMethod.

SetHttpMethod ne fait rien si le nom de la méthode que vous passez correspond à la méthode HTTP par défaut pour le type de transfert. Par exemple, si vous définissez une méthode de travail de téléchargement sur « GET » (la valeur par défaut), la priorité du travail n’est pas modifiée. La méthode HTTP doit être définie avant le premier appel à IBackgroundCopyJob ::Resume qui démarre le travail.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1809 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	bits10_2.h (include Bits.h)
Bibliothèque	Bits.lib

Voir aussi

IBackgroundCopyJobHttpOptions2