IBackgroundCopyJobHttpOptions2::SetHttpMethod-Methode (bits10_2.h)

2024-02-23

Ü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