IBackgroundCopyJobHttpOptions2::SetHttpMethod-Methode (bits10_2.h)

Überschreibt die für eine BITS-Übertragung verwendete HTTP-Standardmethode.

Syntax

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

Parameter

[in] method

Typ: LPCWSTR

Ein Zeiger auf eine konstante NULL-endende Zeichenfolge mit Breitzeichen, die den HTTP-Methodennamen enthalten.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

MIT BITS können Sie als Entwickler eine andere HTTP-Methode als die Standardmethode auswählen. Dies erhöht die Fähigkeit von BITS, mit Servern zu interagieren, die die normalen BITS-Anforderungen für HTTP-Server nicht erfüllen. Beachten Sie Folgendes, wenn Sie eine andere HTTP-Methode als die Standardmethode auswählen.

• BITS ändert die Auftragspriorität automatisch in BG_JOB_PRIORITY_FOREGROUND und verhindert, dass diese Priorität geändert wird.
• Ein Fehler, der normalerweise fortsetzbar wäre (z. B. Konnektivitätsverlust), übergibt den Auftrag in den FEHLERzustand. Sie als Entwickler können den Auftrag neu starten, indem Sie IBackgroundCopyJob::Resume aufrufen, und der Auftrag wird von Anfang an neu gestartet. Weitere Informationen zu BITS-Auftragszuständen finden Sie unter Lebenszyklus eines BITS-Auftrags .
• BITS lässt keine DYNAMIC_CONTENT oder ON_DEMAND_MODE Aufträge mit SetHttpMethod zu.

SetHttpMethod führt nichts aus, wenn der von Ihnen übergebene Methodenname mit der HTTP-Standardmethode für den Übertragungstyp übereinstimmt. Wenn Sie beispielsweise eine Downloadauftragsmethode auf "GET" (Standard) festlegen, wird die Auftragspriorität nicht geändert. Die HTTP-Methode muss vor dem ersten Aufruf von IBackgroundCopyJob::Resume festgelegt werden, der den Auftrag startet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	bits10_2.h (Bits.h einschließen)
Bibliothek	Bits.lib

Weitere Informationen

IBackgroundCopyJobHttpOptions2