Condividi tramite

Metodo IBackgroundCopyJobHttpOptions2::SetHttpMethod (bits10_2.h)

  • Articolo

Esegue l'override del metodo HTTP predefinito usato per un trasferimento BITS.

Sintassi

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

Parametri

[in] method

Tipo: LPCWSTR

Puntatore a una stringa costante con terminazione Null di caratteri wide contenente il nome del metodo HTTP.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

BITS consente, come sviluppatore, di scegliere un metodo HTTP diverso dal metodo predefinito. Ciò aumenta la capacità di BITS di interagire con i server che non rispettano i normali requisiti BITS per i server HTTP. Tenere presente quanto segue quando si sceglie un metodo HTTP diverso da quello predefinito.

  • BITS modifica automaticamente la priorità del processo in BG_JOB_PRIORITY_FOREGROUND e impedisce la modifica della priorità.
  • Un errore che normalmente sarebbe ripristinabile (ad esempio la perdita di connettività) passa il processo a uno stato ERROR. Gli sviluppatori possono riavviare il processo chiamando IBackgroundCopyJob::Resume e il processo verrà riavviato dall'inizio. Per altre informazioni sugli stati del processo BITS, vedere Ciclo di vita di un processo BITS .
  • BITS non consente DYNAMIC_CONTENT né ON_DEMAND_MODE processi con SetHttpMethod.
SetHttpMethod non esegue alcuna operazione se il nome del metodo passato corrisponde al metodo HTTP predefinito per il tipo di trasferimento. Ad esempio, se si imposta un metodo di processo di download su "GET" (impostazione predefinita), la priorità del processo non verrà modificata. Il metodo HTTP deve essere impostato prima della prima chiamata a IBackgroundCopyJob::Resume che avvia il processo.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1809 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione bits10_2.h (include Bits.h)
Libreria Bits.lib

Vedi anche

IBackgroundCopyJobHttpOptions2